الفصل الاول 


عنوان الموضوع: 
الرن ا تجا ين ةكد 


الكلمات المفتاحية: 


مخدم» نص برمجي» مخدم وب» زبون» تطبيق» تقنية» فهر س» استضافة» مستعرض . 


ملخض : 

ا مور ا ون ارش اروا من هة ارو ار ا ن ا ا ا 
ما هي النقاط الإيجابية والسلبية الخاصة لكل من المفهومين ومتى يصبح استخدام النصوص من جهة المخدم ضرورة. 
e o E GE a‏ 
الب وال هاف 


أهداف تعليمية: 

يتعرف الطالب في هذا الفصل على: 

- تعريف النصوص البرمجية من جهة المخدم 

- الاختلاف بين النصوص البرمجية من جهة المخدم والنصوص البرمجية من جهة الزبون 
- مفهوم مخدمات الوب ومخدمات الوب الأكثرانتشاراً 

- التقنيات واللغات المستخدمة في النصوص البرمجية من جهة المخدم 

- كيفية إعداد مخدم 5| وإنشاء مجلدات افتراضية لاستضافة موقع 


ما هو مخدم الوب؟ 
هو تطبيق مهمته استقبال طلبات مصدر ها تطبيقات أخرى تدعى متصفحات الوب (أو زبون الوب)»ء وتقديم 
کی ل قات E‏ 17 ر فو ن ر اتناف ك ا ال ن الان واد اغد 
على البروتوكول التطبيقي 1۲۲۲۶ . 
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النصوص البرمجية من جهة المخدم 


تعريف: 
کا النصوص البرمجية من جهة المخدم إحدى تقنيات مخدمات صفحات الوب والتي يتم فيها الاستجابة 
ديناميكية.-1111لطلب المستخدم والتفاعل معه» عبر تشغيل نص برمجي على المخدم وتوليد صفحات 


ا او البرمجية من جهة المخدم عادة لتأمين تخديم مواقع الانترنت التفاعلية التي تشكل واجهة 
تعامل مع قواعد بيانات أو أي مصدر آخر للبيانات. 


تم تمييز هذه التقنية بعبارة (من جهة المخدم) بسبب وجود تقنيات أخرى تكون فيها مسؤولية تنفيذ النصوص 
البرمجية على عاتق متصفح صفحات الوب (التطبيق الزبون)» وتسمى التقنية باسم النصوص البرمجية من 
جهة الزبون. 


جهة المخدم أم جهة الزبون ؟ (1) 
© 
a‏ 
ر 
aa‏ 
ر 
SS‏ 


Universal Knowledge Solutions s.a.1 2 


حالة النصوص 


ی ی ی ق ا وک ن ا ق 


ر اا ن ادن وی ي مرا ا 

ه يرسل التصفح (التطبيق الزبون) إلى المخدم طلب 11۶[ عبر الشبكة» بهدف استعراض صفحة معينة 
باستخدام محدد الموارد القياسي (ا0R)‏ 

ك ماطف ر مت نامطرب الع عر لفك ى ان لبون 


تمثل الأسهم المتحركة باتجاه المخدم في الشكل الموضح ضمن الشريحة» طلب الزبون والذي يحدد فيه 
الصفحة التي يريد استقدامها من مخدم الوب» في حين تمثل الأسهم المتحركة باتجاه التطبيق الزبون استجابة 


مخدم الوب وإرسال المحتوى المطلوب إلى الزبون. 


جهة المخدم أم جهة الزبون ؟ (2) 


نجد عند دراسة التفاعل بين مخدم الوب وزبون الوب» أننا أمام إحدى الحالات التالية : 
الحالة 1- تحتوي الصفحة على نصوص برمجية من جهة الزبون؛ 


الحالة 2- تحتوي الصفحة على نصوص برمجية من جهة المخدم؛. 

الحالة 3- لا تحتوي الصفحة على أية نصوص برمجية (تحتوي على عبارات ا١1۲‏ فقط). 

ملاحظة: 

يمكن أن تحتوي الصفحة على نصوص برمجية من جهة المخدم» وعلى نصوص برمجية من جهة الزبونء 


يجري عندها التفاعل بين زبون ومخدم الوب وفق الحالتين الأولى والثانية معا. 
نجد عند دراسة التفاعل بين مخدم الوب وزبون الوب» أننا أمام إحدى الحالات التالية : 
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الحالة 1 د تحتوي الصفحة على نصوص برمجية من جهة الزبون: تجري ترجمة وتفية التصرصن 
الرمسخية المحاة في الصفحة الما نة من فل الزيرن بت انشاهه الصفدة نطق على هذه التصرض: 
النصوص البرمجية من جهة الزبون . 


الحالة 2 - تحتوي الصفحة على نصوص برمجية من جهة المخدم: تجري ترجمة وتنفيذ النصوص 
البرمجية المحتواة في الصفحة التي أرسل الزبون في طلبهاء من قبل المخدم قبل إرسال الصفحةء نطلق 
على هذه النصوص»› النصوص البرمجية من جهة المخدم . 


الحالة 3- لا تحتوي الصفحة على أية نصوص برمجية (تحتوي على عبارات ا۷١11‏ فقط): يرسل 
المخدم الصفحة إلى الزبون الذي يستعرضها. 


ملاحظة: 
يمكن أن تحتوي الصفحة على نصوص برمجية من جهة المخدم» وعلى نصوص برمجية من جهة الزبونء 
يجري عندها التفاعل بين زبون ومخدم الوب وفق الحالتين الأولى والثانية معا. 


ما أهمية النصوص البرمجية من جهة المخدم؟ (1) 


للإجابة على هذا السؤال ينبغي علينا الدخول في مقارنة بسيطة بين النصوص البرمجية من جهة المخدم 
والنصوص البرمجية من جهة الزبون من خلال سرد أهم النقاط الإيجابية والسلبية لكل منهما. 


النصوص البرمجية من جهة الزبون: 


النقاط الإيجابية: 

DHTML lدخٿساب تساعد في دعم الحركة على الموقع‎ ٠ 

٠‏ تتحمل جزء من حمل المعالجة على المخدم حيث تتم عملية ترجمة وتنفيذ النص البرمجي على الحاسب 
الزبون 

٠‏ تؤمن التفاعل مع المستخدم دون الحاجة إلى إعادة الاتصال مع المخدم (مثال عملية التأكد من بعض 
أخطاء البيانات المُدخلة في نموذج معين) 
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النقاط السلبية: 

ك رة فى الرضرل لي آي مورد من مرارة يخم رل ى آي تشين من اقات فة 
به مل تطيقات إذارة قوآعد المعطيات. إذ يكون المضدر الوحيد يانات التي يمكن النضوص البرمجية من 
جهة الزبون الوصول إليهاء هي المعلومات المحتواة في الصفحة نفسها والتي تحويء النص البرمجيء» أو دخل 
اعد ا مات من شات کي جار زيون ى حل د ف اة ورن ى ف ادات 
عن طريق المتصفح). 

٠‏ توجد عدة لغات برمجة مُستخدمة في كتابتهاء مما يعزز فرص عدم توافقيتها الكاملة مع كافة المتصفحات 
روج بن المشفحات خير قادرة لى ها 

د .ارف الان اكائى غد افد اها إا كن زيون أن يركن سرلا بترن انرص ارمجة 
من جهة الزبون لأنها تكرن جز ءا من التص المصدري (الذي يمكن استعراضه بالخيار 6#٣ناهء‏ س6ز من 
خيارات المتصفح) مما يجعل عملية استخدام أي نوع من التحقق أوكلمات السر من جهة الزبون غير آمن 
بالشكل الكافي. 


ما أهمية النصوص البرمجية من جهة المخدم؟ (2) 
النصوص البرمجية من جهة المخدم: 


النقاط الإيجابية: 

تطح وها كل من جهة المفدد الرضرن إلى مرارد لمكم ر لت المرقطة به مل 
تطبيقات إدارة قواعد المعطيات. 

- يولد تطبيقها صفحات ا1۲ قياسية يستطيع أي متصفح تفسيرها واستعراضها أيا كانت لغة البرمجة 
المستخدمة في كتابة هذه التصوص البرمجية: 

ا وع لرن تاعا ن ها يل اسک هو ن ا 11 تاح عن شر ,ان 
النصوص البرمجيةء مما يجعل محتوى النصوص البرمجية من جهة المخدم أكثر أماناً. 


النقاط السلبية: 
ر عة قاع فى التصرض ارم من خة المخد بط ها شلب الاتسالن الم ج 
لفاغ 
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- يتحمل المخدم عبء عمليات ترجمة هذه النصوص البرمجية. 


التقنيات المستخدمة في النصوص البرمجية من جهة المخدم 


من أشهر التقنيات المستخدمة في تطوير النصوص البرمجية من جهة المخدم: 


PERL 

ASP 
ASP.NET 
PHP 
ColdFusion 
JSP 


تاريخيأًء جرى تطوير النصوص البرمجية من جهة المخدم» اعتمادا على لغات البرمجة التقليدية أو اللغات 

الخطاطية التقليدية مثل ٤‏ و |۴6۲ و أمأ٣٥ء‏ اا6 بحيث كان التطوير يعتمد على إنشاء ما يسمى ب 
gateway interface) CGI‏ onصmmصc0€)‏ اتحصیل المعطیات التي یرسلها الزبون وللتعامل معھا. وقد 
كان نظام التشغيل الذي يعمل عليه مخدم الوب» هو المسؤول عن عملية تنفيذ هذه البرامج بحيث كان يجري 


جرى حديثاً تطوير تقنيات أخرى» كتلك التي تعتمد لغات مثل ۸8۴ و ۴» بحيث يجري تتفيذها مباشرة 
من قبل مخدم الوب أو عن طريق وحدات برمجية إضافية وضمن فضاء العمل والعنونة المخصصين لمخدم 
الوب. 


من أشهر التقنيات المستخدمة في تطويرالنصوص البرمجية من جهة المخدم: 
۰ اPER#1:‏ لم يجر تصميم هذه التقنية لكتابة النصوص البرمجية الخاصة ببيئة الوب» ولكنها أثبتت فعالية 
عالية في هذا المجال» وهي ما تزال مستخدمة لكتابة برامج ا@© والوحدات الخاصة بمخدم الوب 


۸PACHE‏ نظراً لإمكانياتها الكبيرة في معالجة سلاسل المحارف» وهي العناصر التي يتم تبادلها بشكل 
أأساسي في تطبيق وب. تأخذ ملفات النصوص البرمجية التي تستخدم هذه التقنيةء اللاحقة ۴1. 
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٠‏ ۸5۴: جرى تطوير هذه التقنية من قبل شركة مايكروسوفت» وهي تستخدم لغات مثل أمأ٥S‏ 2۷2ل 
و أمأ٣S‏ 8/. تأخذ ملفات النصوص البرمجية التي تستخدم هذه التقنيةء اللاحقة ۲؟۸5. 


هھ AP NET‏ جز ی تطریر هذه اة ایا من قل شرکة ماگرو شت وز گکزت نے عق 
البرمجة المقادة بالأحداثء واعتماد إطار عمل ٤E"‏ .". تأخذ ملفات النصوص البرمجية التي تستخدم هذه 
التقنيةء اللاحقة ×۸8۲. 


P1۴ ٠‏ : جرى تطويرها كتقنية من تقنيات المصادر المفتوحة (6٥1۲ا50 »)006١‏ وهي تكافئ تقنيية 
8P‏ من حيث إمكانياتهاء مع تمتعها بميزة الإنفتاح وبإمكانية التطوير والتحسين والتوسع من قبل العديد من 
الجهات نظرا لكونها مفتوحة المصدر. تأخذ ملفات النصوص البرمجية التي تستخدم هذه التقنيةء اللاحقة 
.PHP‏ 


Fusion‏ اC0:‏ وهي نسخة تجارية من التقنية التي طورتها شركة ۸40۲0۳١82‏ لدعم النصوص 
البرمجية من جهة المخدم. تتوفر هذه التقنية على أكثر من بيئة عمل وتدعم التعامل مع أكثر من نظام إدارة 
قواعد بيانات. تأخذ ملفات النصوص البرمجية التي تستخدم هذه التقنيةء اللاحقة ۴©. 

Sل:‏ وهي تقنية مبنية على لغة جافا لبناء نص برمجي من جهة المخدم. تتوفر هذه التقنية على أكثر 


من بيئة عمل u×(‏ ˆ |أا/× "i‏ لWNS/0‏ 00" |). تأخذ ملفات النصوص البرمجية التي تستخدم هذه التقنية» 
اللاحقة ٣‏ 9ل. 


مخدمات الوب الأكثر انتشاراً 


Ap ache‏ ا رر 
HTTP SERVER PROJECT‏ 


:Apache ps ® 


:[IS(Internet Information Services) as ® 


A Windows Server System 
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:Sun Java MicroSystem Web Server as ® 


ava 


POWERED 


:Zeus مخدم‎ ۵ 


9 
Z7 € لا‎ 5 


:Apache pدخ‎ 

يعتبر مخدم عطء2م4» نظام مفتو ح المصدر قدمته Apache software ound a10١1‏ ویتوفر مع رامعا غل مات 
.Windows «Novell «Unix «Linux Jae‏ 

يتمتع هذا المخدم بالكثير من الخصائص المميزة نذكر منها: دعمه للعديد من لغات البرمجة متل ۲1عم» ططم» ودعمه 
للبروتوكو لات الآمنة 5S1‏ و 118» وتوفيره لإمكانيات التحكم بشكل صفحات الخطأء بالإضافة إلى توفر رمازه على نحو مفتوح 
مما يسمح بتطويره وتحسينه ومعالجة ثغراته بصورة أفضل وأسرع. يعد هذا المخدم من أكثر مخدمات الوب شعبية وانتشاراً 
على الإطلاق بحسب إحصاءات عام 2005. 


aخدڏم HIS(Internet Information Services)‏ 
جرى تطوير هذا المخدم من قبل شركة ا؟هوهإءM‏ وهو عبارة عن مجموعة من الخدمات المخصصة لبيئة الوب والتي تعمل 
على نظام التشغيل sسهلہ۷1.‏ يتم توزيع هذا التطبيق حالياً كخدمة من نظم التشغيل 2000 Windows 2003 s Windows‏ 

Windows XP pro server 
ويْعتبر مخدم 118 المنافس الأقفوى‎ . ۴P, SMTP, NNTP, HT 1 °/] 71۲$ تتضمن النسخة الحالية 6.0 118 خدمات‎ 
لمخدم عءطءهم4 من حيث الشعبية والانتشار» ولكنه» وحتى نسخته الحاليةء يعاني من بعض نقاط الضعف وخ صوصضامن‎ 
النواحي الأمنية. وقد جرى تجاوز العديد من الثغرات في النسخة التجريبية 7.0 118 وجرى تصميمها على شكل وحدات‎ 

ومكونات منفصل مما يضيف مرونة أكبر في التعامل مع هذه المكونات. 


: Sun Java MicroSystem Web Server aa 

جری تطوير هذا المخدم من قبل شركة enاsر؟0ءMi‏ «ں؟ يُدعی حالیاً 0۸۴ N×ا؟.‏ يتميز هذا المخدم بخصائص أمان 
عة هرا استكال مما ية مخضا لقطمقات الل المقرسطة والكبرة 

يتوفر المخدم على أغلب منصات العمل وهو يعطي العديد من الميزات للتطبيقات التي تستخدم تقنيات ۸۷۸[ و۴؟[ كما يدعم 
تقنیات ۸8° و P۴1۴‏ وتقنیات .°C61‏ 
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مخدم Sا76:‏ 

تم تطوير هذا المخدم من قبل شركة رإعهام«طءع) وuاعZ»‏ وهو يحتل المرتبة الأولى من حيث السرعة منذ عشر سنوات» 
ویعمل على منصات عمل N1×‏ ا بمختلف أنواعها. 

الخطوات التي تسبق عملية التثبيت: 


- التأكد من تغطية عتاديات المخدم للحاجات الدنيا لنسخة 118 التي نثبتها. مثلاء ينصح باستخدام مخدم 
بذاكرة أولية 512 ميغابايت ومعالج ۶4 كحد أدنى»ء عند استخدام النسخة 6.0 118ء. 

- التأكد من تثبيت عائلة البروتوكو لات ۲۳۲/1۴ وذلك عن طريق إعدادات خصائص الاتصال الشبكي. 
- إعداد القرص الصلب الخاص بمخدم 118 وتهيئته باستخدام نظام الملفات .N1۴۶‏ 


تتضمن عدة إصدارات من نظام التشغيل وس هل۷1 المخدم 118 كإحدى خدماتهاء لتبيت هذا المخدم نتبع 
المراحل التالية: 


1- نضغط زر S2۲‏ ثم نختار خيار لوحة التحكم. 
2- نختار خيار إضافة أو إزالة برامج ونحدد خيار إضافة أو إزالة مكونات sس0ل«ذ۷‏ ونفعل خیار مخدم 
3- يمكننا اختيار جزئيات التشبيت من خلال النقر على زر كانه)ء5. 


ملاحظة: 


نلاحظ بالنقر على أيقو نة 01م Administrative‏ من خيارات لوحة التحكم ظهور أيقونة خاصة للوصول 


8 


إلى 118. 


Internet Information Sef Yices 
Shortcut 
ã EB 


كما نلاحظ أيضاً أنه يجري تلقائيا عملية إضافة مجلد باسم 8ا 1N8E1۴‏ ضمن القرص الصلب الذي يجري 
تثب . IR‏ عليه. 
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واجهة إدارة مجموعة مخدمات 11S‏ 


تتکون واجهة إدارة 5 كما يظهر الشكل أدناه» من قسمين رئيسيين: 


o‏ القسم الأيسر الخاص بإظهار مخدمات 118 العاملة على نفس الجهاز أو على عدة أجهزة ضمن 
الشبكةء بالإضافة إلى الخدمات العاملة ضمن هذه المخدمات والمجلدات الرئيسية ضمنها. 
o‏ القسم الأيمن الذي تظهر فيه الفهارس الفرعية والملفات المحتواة ضمن هذه المجلدات. 


+ ğ Internet Information 5ery¥ices 


Fils Artin Yiewy Help 
a A E EEE EET 


Default Web Site Stopped} Stopped 


Internet Information Seryices 


2-4 SKEAIT {local computer} 
ê Web Sikes 
` Hg Default web site (stopped) 
Ey Default SMTP Yirtual Server 


يقدم IIS‏ خدمات متعددة فهو يعمل کمخدم SMTP‏ وکمخدم FTP‏ إضافة إلى عمله کمخدم ولبا. کما یمکننا 
تفعيل وإيقاف تفعيل أي من الخدمات باستخدام خيارات إه)؟ - مه٥)؟‏ - مه۴ عبر النقر بالزر الأيمن 
على أية خدمة من هذه الخدمات. 


ملاحظة: 


يمكننا ضبط الإعدادات التلقائية لمخدم وب 118 بالنقر على الخيار ,)٥م٠۴۲‏ من قائمة شريط الأدوات. 


استضافة مواقع الوب في 118 


تعتمد الفكرة الأساسية في استضافة المواقع على إنشاء مجلدات تحتوي وثائق وصفحات ال ٢٥1M‏ المراد 
نشرهاء بالإضافة إلى النصوص البرمجية التي تعمل من جهة الزبون أو من جهة المخدم. يتولى مخدم 118 
دور الوسيط الذي يستقبل طلبات متصفح الوب ويعيد المحتوى المناسب من المجلد المناسب. 
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ن٤‏ مجلداً تلقائياً باسم ١0٥س‏ سس يعتبر المجلد الرئيسي التلقائي. كما يقدم 115 آلية لإضافة مجلدات 
أخرى وإدارتها. حیث e‏ ك هده 1 جاد ات جذر شجرة أ جاد ات التي تحتوي وثائق وصفحات مواقع الوب. 


نكن قز فة رب تسيتها رفق إن الضقحة الفقافة المخد ضفن إعذادات مخ الريب لها إلى 
المجلد الللقاتي المحذد ضمن شن (عددات المخد بحيت يكن لمتصفح الوب فى الوصول إليها واستعراضها 
تلقائياً عد اتصاله بالمخدم. 


ماهي المجلدات الاافتراضية؟ 


لتمكين وصول مستخدمي المتصفح إلى صفحات موقع غير محتواة ضمن المجلد الرئيسي التلقائي يمكننا إنشاء 
ما يسمى بالمجلد الافتراضي. 


يظهر المجلد للمتصفح وكأنه محتوى ضمن المجلد الرئيسي التلقائي بالرغم من كونه غير محتوى فيزيائيا 


ضمنه. 
يمتلك كل مجلد افتراضي اسم بديل (أو اسم مسار)»ء وهو الاسم الذي يستخدمه المستعرض للوصول إلى هذا 
المجلد ويكون عادة أقصر من المسار الفيزيائي الحقيقي لهذا المجلد. 
تؤمن المجلدات الافتراضية عدة مزاياء نذكر منها: 
1- درجة أمان أعلى كونها تحجب عن المتطفلين» المسار الفيزيائي الحقيقي للمجاد. 
2- سهولة عملية إدارة المخدم» وجعل عملية نقل الملفات فيزيائياً -من مكان إلى مكان آخر على القرص- 
عملية سهلة لا تسبب أي تغيير للعناوين المستخدمة ضمن الصفحات. 
3- سهولة استذكار المسار الافتراضي كونه أقصر من المسار الفيزيائي. 
إضافة مجلد افتراضي لاستضافة موقع 
لإضافة مجلد افتراضي بغرض استضافة مجموعة من صفحات الوب» ننقر بالزر الأيمن على خيار اه5 


sit‏ تم نختار من القائمة سء" الخيار إاه]ءع ۲ال اهسuا۷1۲.‏ تؤدي هذه العملية إلى تشغيل معالج 
كاض اء الات الافر اة 


ه يطلب تحديد الاسم المُستخدم للوصول إلى هذا المجلد؛ 
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ه يطلب تحديد اسم الموقع الفيزيائي لهذا المجلد على القرص؛ 
ف ات كه ات فل تات ا اك 


بعد ضبط هذه الإعدادات يصبح بإمكاننا وضع ملف من نمط ا١11‏ ضمن المجلد الفيزيائي الحقيقي الذي 
يمثله المجلد الافتراضي ويصبح بإمكاننا استعراضه عن طريق متصفح الوب» حيث يمكننا الوصول إلى 
محتوى صفحة الوب مباشرة باستخدام محدد الموارد القياسي ا0R.‏ 


مثال: 


ونكل لرن 8 1012175 ك مد المررة القاني: 


http://10.12.17.5/myweb/test.html 


فإذا کان لدینا مخدم (N8‏ نستطیع ربط طاعسرہ/1))p://10.12.17.5‏ باسم نطاق معین فیصبح محدد 
الموراد القياسي من الشكل: 


http://mydomain.com/test. html 
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عنوان الموضوع: 
النماذج ف XHTML‏ 


الكلمات المفتاحية: 


الفصل الثاني 


نموذج» واصفة»ء تأشيرة» عنصر› قيمة»› حدث» إرسال» حقل نصي»› حقل اختيار»› زر“ إعادة تأهيل. 


ملخض : 


النماذج في 17× 
تعد النماذج واجهة التفاعل الأساسية بين المستخدم والتطبيقات العاملة على المخدم والنصوص البرمجية من جهة المخدم. تغطي 


هذه الجلسة النماذج وعناصرها المختلفة. 


أهداف تعليمية: 


يتعرف الطالب في هذا الفصل على: 


XHTML ùe ةحanl‎ 


0 النماذج في XHTML‏ 


XHTML عناصر نماذج‎ e 


O 
O 


O 


13 


الحقول النصية 
حقول الاختيار 
الأزرار 

الحقول المخفية 


ما ي XHTML‏ ؟ 
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هو عبارة عن معيار متقدم عن المعيار 1114.0 جرى وضعه لبناء نسخة 171 متوافقة تماما مع الشروط الصارمة للمعيار 
1× من ناحية أسلوب كتابة التأشيرات» واحترام إغلاق كل تأشيرة مفتوحةء والتركيز على التداخل الصحيح للتأشيرات» وعدم 
التسامح في تجاوز بعض التأشيرات» واستخدام الفواصل: (" ") لتحديد قيم الواصفات مثل ”عں[ه۷”=٠اطن٤اA»‏ وغيرها. 


النماذج في XHTML‏ 


الغرض من النماذج: 

ه تعرف النماذج بأنها آلية تهدف إلى جعل صفحات 1۲۷1 أكثر تفاعلية. وتسمح النماذج لمستخدمي 
صفحة الوب بتوزيع البيانات ضمن حقول محتواة في صفحة ا1۲۷ وإرسال هذه البيانات إلى مخدم الوب 
حيث تجري معالجتها 

E yS o 
ا‎ E ا‎ 


مكونات النموذج: 

٠‏ يتكون النموذج من حقل إدخال أو أكثر. يمكن أن تكون هذه الحقول» حقول إدخال نصية»ء أو أزرارء أو 
مربعات اختیار › أو قوائم» أو حتى خرائط صور 

>f]هاص<‎ >/؟هإ٣< تكون عناصر النموذج محصورة بين التأشیرتین:‎ ٠ 

٠‏ يحتوي النموذج مكونات ا1۷[ أخرىء» فهو لايقتصر بالضرورة عناصر النموذج. فعلى سبيل 
المثال» يمكن للنموذج أن يحتوي نصوصا وصوراً (تساعد في شرح كيفية ملء حقول النموذج). كما يمكن 
للنموذج أن يحتوي على نصوص برمجية من جهة الزبون» مكتوبة بلغة e‏ أو غيرهاء تساعد في 
عملية تقييم البيانات 


ع ا سل اعرا المع ار هت مات اتل ى ا اا ایکون ر 
إلكتروني أو إلى نص برمجي من جهة الزبون. يُعبر الشكل التالي عن نموذج تقليدي: 
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First Name EEG 


Last Name EE 


Password 
Nex f“ Mlale ` Female 
Country Select 4, Country ¥ 


Address damascus syria 


Submit Reset 


عناصر النموذج: الواصفة ك0ط٤ءM‏ 


E Nas sS TTPO LE E aa 

- حالة نموذج يستخدم طريقة :۴0S1‏ حيث يجري توجيه المتصفح لإرسال البيانات إلى مخدم وب أو 
إلى عنوان بريد إلكتروني» ضمن أغراض خاصة يتضمنها الطلب 1١۲۴‏ المُرسل إلى المخدم. 

- حالة نموذج يستخدم الطريقة E1‏ 6: حيث يجري توجيه المتصفح لإرسال البيانات إلى مخدم وب أو 
إلى عنوان بريد إلكتروني» على شكل سلسلة محارف تضاف إلى المُحدد R1‏ 0 ضمن طلب 1۲۲۴ المُرسل 
إلى المخدم. 


بالإضافة إلى طريقتي 6٤1‏ و ۴0S1‏ هناك العديد من الطرق الأخری لإرسال طلب 1١۲۶‏ متل الطرق 
Connect »T race Delete «PUT‏ لکننا سنتعامل حصر مع الطریقتین 6٤1‏ و ۴051 وسنستعرض 
لاحقاً الفروق الأساسية بين هاتين الطريقتين. 


عناصر النموذج: الواصفة 0ذ۸ 


٠‏ تحدد الواصفة ١٥ء۸‏ للمستعرض العنوان الذي يجب أن تصل إليه البيانات المُرسلةء إذ يمكن أن 
تكون القيمة المسندة للواصفةء عنوان بريد إلكتروني» أو محدد 01 لصفحة تحتوي على نص برمجي من 
جهة المخدم. 

٠ه‏ تتم عملية الإرسال» والوصول إلى العنوان المحدد في الواصفة ١,٠٥1)ء۸»‏ عند نقر زر الإرسال 
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.Submit 


:1 مثال‎ 
<FORM METHOD=” POST” ACTION="SK@scs-net.org’”> 


١ COREERE 
</FORM> 


يقوم هذا النموذج» عند ضغط زر اط طن؟» بحزم البيانات وإرسالها كرسالة بريد إلى عنوان البريد المحدد 


.SK@scs-net . org في المثال‎ 


:2 مثال‎ 
CEORM MEN HODE EOS RECTTONZ GCE INO ASO > 


 COMEEME 
</FORM> 


يقوم هذا النموذج» عند ضغط زر انط ا5ء بحزم البيانات وإرسالها إلى الملف ×میھ.٥٤ہآ)ءع‏ على المخدم 
والذي يحتوي النص البرمجي الخاص بمعالجة البيانات المُرسلة. 


مثال 3: 


<FORM METHOD=”GET” ACTION=”"Test.php”> 
. COnNtEnNL 
</FORM> 


يقوم هذا النموذج» عند ضغط زر انصطن؟» بإرسال إلى ملف مطم.ء٠1‏ وذلك بإضافة البيانات إلى محدد 
JR‏ الخاص بالصفحةء فإذا كانت إحدى الحقول المراد إدخالها هي 4۳# وكانت قيمة الحقل هي نصهيء 


http ://myDomain.com/Test.php? name=sami 


مم آEncعناصر‏ النموذج: الواصفة 


ه٠‏ تحدد الواصفة ١ءمرآء81‏ نمط الترميز المُستخدم عند إرسال بيانات النموذج. تأخذ هذه الواصفة قيمها 
من أنماط المعيار »11M٤‏ وهو معیار يوصّف اسلوب ترمیز البیانات» جری تطويره لترميز البيانات 
المختلفة ضمن شكل نصي وباستخدام حروف الأبجدية. 


٠‏ يجري تحديد نمط الترميز على النحو التالي: MIME ype /MIMESub Type‏ . فعلى سبیل المتال 
يظهر نمط الترميز التلقائي والذي يُعبّر عن القيمة التلقائية للواصفة عم راء" كما يلي: 


<Form ENCTYPE=application/x-www-form-urlencoded> 
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حيث يصلح الترميز السابق لجميع نماذج الوب عدا تلك التي تتطلب إرسال ملفات إلى مخدم الوب» والتي 
<Form ENCTYPE=multipart / form-data>‏ 


عناصر النموذج: الواصفة AcceptCharSet‏ 


ضرورية خصوصاً في النماذج متعددة اللغات. تكون القيمة التلقائية لهذه الواصفة NK N0 W١‏ التي 
تشير إلى استخدام نفس قاتمة المحارف المستخدمة في ترميز النموذج. 


٠‏ عند الحاجة لاستخدام أكثر من قائمة محارف» يمكن وضع قيم الواصفة السابقة على شكل قيم متتالية 
يجري فصلها بفاصلةء كما هو الحال في المثال التالي: 


<Form AcceptCharset=“windows-1256,1i1so0-8859-17”> 


عناصر النموذج: الواصفة ٤٤عإ۾1‏ 


ا الواصفة ع1۲ في بيئة الصفحات متعددة الأطر. تعبر قيمة هذه الواصفة عن اسم الإطار الهدف 
الذي ستظهر فيه الإجابة بعد إرسال النموذج (في حال أعاد النص البرمجي من جهة المخدم أي خرج). فعلى 
سبيل المثالء تستخدم هذه الواصفة عند الحاجة لإدخال بيانات خاصة بنموذج بحث متوضع ضمن إطار ما في 
صفحة ا1۲ وعند الحاجة لاسترجاع نتيجة البحث ضمن إطار آخر. 


تأخذ الواصفة )عع۲ه) القيم: 

ه٠‏ ”Kمهاط_“:‏ تجري إعادة خر ج النموذج في نافذة جديدة بدون اسم. 

٠ه‏ #آعء_“: تجري إعادة خر ج النموذج ضمن نفس الإطار الذي يحوي النموذج. 

° renوم_“:‏ تجري إعادة خر ج النموذج ضمن الإطار الأب للإطار الذي يحوي النموذج. 

٠‏ ”ص٥_“:‏ تجري إعادة خرج النموذج ضمن الإطار الرئيسي مع إزالة كل الإطارات الأخرى. 


<form action=” SomeThing.aspx” method=” POST” Target=”_blank” > 


:ONRESET gy ONSUBMIT ثlدحİلا‎ 
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يجري تنفيذ الحدث ©NS18 M1١‏ عند إرسال النموذج بضغط زر اأصطانء. 

۵ يجري تنفيذ الحدٿ ٥©١×/R٤SE1‏ عند إلغاء معلومات النموذج بضغط أع؟ع] . 

مثال: 
<form action=”test.aspx” method=” POST’ onsubmit= ”window.alert( ‘submitted successfully’); >‏ 


تظهر« عند إرسال هذا النموذج« lلرllwة “submitted successfully”‏ 
عناصر النموذج: واصفات أخرى 


لا تقتصر واصفات وأحداث النماذج على تلك التي قمنا بشرحها في الشرائح السابقةء إذ توجد واصفات 
وأحداث أخرى سنذكر بعضها فيما يلي: 


فن هذه آلو اقات 


- 10 تستختم هذه الواصفة لتحديد اسم فريد للنموذج. 


- كها: تستخدم هذه الواصفة في حال الرغبة باستعمال الأنماط الخاصة بملفات C88‏ المُعرفة ضمن 
التأشيرة ٥1روا‏ من نفس الوثيقة. 

- مارا8: تستخدم هذه التأشيرة لتعريف أنماط يجري استخدامها في تنسيق عناصر الوثيقة. 

1104 تخ اتيد عنران الخصر. حيث يفيه المتصفح من قمة هذه الرأصفة لإظهار مرب 


يحتوي هذه القيمة لدى مرور مؤشر الفأرة فوق العنصر. 
ومن هذه الأحداث: 


NCL €5 -‏ يجري تنفيذ الإجرائية المُسندة لهذا الحدث» عند النقر بالزر الأيسر فوق العنصر 

NDB |] L1K -‏ يجري تنفيذ الإجرائية المُسندة لهذا الحدث» عند النقر المزدوج بالزر الأيسر فوق 
التو 

O NMOJSEDOWN =‏ يجري تنفيذ الإجرائية المسندة لهذا الحدث» عند الضغط بالزر الأيسر فوق 
الفأضبر 

NMOJSEUP  -‏ يجري تنفيذ الإجرائية المُسندة لهذا الحدث» عند تحرير الضغط عن الزر الأيسر 
فوق العنصر 

NMOJSEOVER =‏ يتم يجري تتفيذ الإجرائية المُسندة لهذا الحدث» عند وضع مؤشر الفأرة فوق 
الفتحنر 
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NMOJSEMOVE  -‏ يجري تتفيذ الإجرائية المُسندة لهذا الحدثء عند تحريك مؤشر الفأرة فوق 


الفتح. 
NMOJSEOUT =‏ يجري تتفيذ الإجرائية المُسندة لهذا الحدث» عند خروج مؤشر الفأرة من 
المساحة التي يحددها العنصر 

NK EYPRESS -‏ يجري تتفيذ الإجرائية المُسندة لهذا الحدث» عند ضغط وتحرير مفتاح فوق 
التسر 


NK EYDOWN =‏ يجري تنفيذ الإجرائية المُسندة لهذا الحدث» عند ضغط مفتاح فوق العنصر 
NK EYUP  -‏ يجري تنفيذ الإجرائية المُسندة لهذا الحدث» عند تحرير مفتاح فوق العنصر 


عناصر النموذج 


<form method=” POST” action=” Test.aspx” 

target=”_self’ ID=”myForm” 

class=” normalForm” EncType=” multipart/form-data” dir=”ltr” 
onclick=” window.alert( ‘you clicked the form’) > 

... Contents 

</form> 


٠‏ يستعرض هذا المثال نص 11۷11 يعرف نموذج يعتمد على الطريقة ۴0S1‏ في إرسال البيانات 
يحدد النموذج الملف ×مكه.اءع)» كملف هدف يحتوي نصا برمجياً من جهة المُخدم ويجري إرسال 
البيانات إليه للمعالجة 

٠‏ تظهر الاستجابة على هذا النموذج (كنتيجة لتنفيذ الملف ×مه.1ءع]) ضمن نفس الإطار الذي يظهر فيه 
النموذج» لأن النموذج استخدم القيمة ”61۴؟_“ 

٠‏ يمتلك النموذج السابق الإسم ”۲۳٥۴روص“‏ ويجري تطبيق النمط ۳٣۲٠۴اةمإمم“‏ على هذا النموذج 
لا كان بكرن ها انعط سرف مسقا ضفن رقة 095 أي ضسن فن الرققة باستخذام التافيرة 
(STYLE‏ 

٠‏ يستخدم في هذا النموذج الترميز ”هة ل-١٣١٥؟/١4م1)اسص“‏ مما يعني أن النموذج يُرسل محتوى ملف 
إلى المخدم 

٠‏ تظهر الرسالة ٤٥۲۳‏ عط ickedاc‏ uمر“‏ عند النقر على النموذج 


حقول النماذج: الحقول النصية 
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يمكن استخدام عدة أنواع من الحقول النصية في النموذج نستعرضها فيما يلي: 
حقل إدخال نص: 


٠‏ تبر حقرل ذخال التصوض من أكتر أنراع الحقول استخداماً في النماذج. يتالف خقل هال القضن من 
حقل فار غ مخصص لإدخال سطر وحيد 

يجري تحديد حجم هذا الحقل باستخدام الواصفة م512 ويجري تحديد عدد المحارف المسموح إدخالها 
بالو اصفة 1عمعا×و" حيث تقاس ع81 و طاعمعا×ة" بعدد المحارف 

٠‏ يمكن أن تكون الواصفة ط)ع١ءا×ه.‏ أكبر من الواصفة ع1z؟.‏ في هذه الحالة يجري زلق محتويات 
الحقل النصي أثناء الكتابة 

٠‏ يمكن استخدام الواصفة عں اه۷ لإعطاء قيمة تلقائية للحقل 


لا يوجد في 1۷1[ أية آلية مباشرة للتحكم بنوع المدخلات» لذا نلجاً إلى النصوص البرمجية من جهة 
الزبون» أو إلى النصوص البرمجية من جهة المخدم» لتقييم البيانات وإظهار رسائل الخطاً في حال عدم 
تطابقها مع نمط أوتنسيق البيانات المطلوبة. 


مثال: 
لإنشاء حقل نصي باسم عامصة5رإص يحتوي على قيمة تلقائية هي اءع)» ويكون بطول 10 محارف» وبعدد 
أقصى من المحارف يبلغ 40 محرفاء نكتب النص التالي: 


<input COS UE name=”mySample” value=" test” Size=” 10” 
maxlength=40 /> 


حقول النماذج: الحقول النصية 
حقل إدخال كلمة السر: 
٠ه‏ يستخدم هذا النمط من الحقول النصية كالحقول النصية العادية مع تطبيق قناع يخفي المحارف المُدخلة. 
إذ لا يتمكن الناظر إلى الشاشة من رؤية المحارف» بل يرى عوضاأ عنها محرف القناع الذي غالبا ما يكون 


أحد المحارف "0" أو ck99‏ 
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٠‏ يجري إظهار المحرف القناع ('0" أو ”*) أثناء عملية الإدخال أمام الناظر إلى الشاشةء ولكن هذا لا 
يعني أن المحارف تكون مقنعة بالنسبة للبرامج العاملة على الجهاز الذي تجري عليه عملية الإدخال أو أثاء 
عملية إرسال البيانات إلى المخدم. 

مثال: 


<InNOUL LVDEIDaSSWOEA hame myEPasSt Size 410 maxlenglthn 25 /> 


حقول النماذج: الحقول النصية 
حقل إدخال اسم ملف: 


٠‏ يسمح هذا النمط من حقول الإدخال النصية للمستخدم باختيار ملف حتى يجري إرساله إلى المخدم 

١‏ يكون اسم الملف محتوى في نص يعبر عن المسار الذي استخدمه المتصفح للوصول إلى الملف 
يقوم هذا النمط بإظهار الحقل النصي» إضافة إلى زر يساعد في استعراض المجلدات بحثا عن الملف 
المطلوب 

٠‏ ليعمل هذا الحقل» لا بد من استخدام الطريقة ۴051 في إرسال بيانات النموذج وعدم استخدام الطريقة 
GET‏ 

٠‏ يمكن استخدام الواصفة امءءء۸ مع هذا النمط للسماح بإرسال نمط معين من الملفات. تحدد قيم 
الواصفة 1م٥۲٥۸‏ بنمط ×]1M٤‏ للملفات المراد إرسالها 


مثال: 

<input type=” file” size=8 name=”myFile” accept=”text/*” />‏ 
في هذا المثالء» يجري إنشاء حقل من نمط حقل ملف بإسم ٥۴1إص»‏ بحيث يكون عرض الحقل 8 محارف» 
وبحيث يقبل هذا الحقل الملفات من النمط ×1۴ بجميع أنماطه الفرعية مثل 
.(text/html, text/css text/plain)‏ 


عناصر النماذج: الحقول النصية 


حقل إدخال نص متعدد الأسطر : 


يساعد هذا النمط من الحقول في إدخال نص متعدد الأسطر وذلك باستخدام التأشیر ة <۴۸ .>۲۴٤×X1۲۸R‏ 


من أهم الواصفات الخاصة بهذه التأشيرة: 
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- الواصفة sسهR0‏ التي تحدد عدد الأسطر 

الواصفة ءاه التي تحدد عدد الأعمدة 

- الواصفة مهس التي تحدد قابلية النص للالتفاف عند تجاوز عرض مساحة النص. يمكن لقيمة الواصفة 
ن تأخذ إحدى القيم ”۴ه“ أو ”امس)ذب“» أو ”اةعزورط۴“» حيث تساعد القيمة ”۴ه“ في تعطيل التفاف 
النص» بينما تساعد القيمة 17ا٤¡“‏ في تثبيت التفاف النص ولكنها لا تقوم بإضافة أي فاصل إلى البيانات 
التي يجري إرسالها بعكس القيمة ”هء1ورط۴“ التي تضيف فاصل سطر حقيقي عند كل التفاف للنص 
ويجري إرساله مع البيانات عند إرسال النموذج. 


“e 


مثال: 
<TEXTAREA rows=” 10” cols=" 6” name="myTextArea” wrap="off”">‏ 


. THIS 1S 4 EOS 
</TEXTAREA> 


ينشئ هذا المثال مساحة نصية بعرض 6 محارف وارتفاع 10 محارف باسم 2١A۲)×ع‏ 1ر" ويجري في هذا 
النموذج تعطيل خاصة التفاف النص. 


حقول النماذج: حقول الاختيار 


يندرج تحت هذا التصنيف الحقول ذات الأنماط التالية: 


٠ه‏ ينشئ هذا النمط من الحقول عنصر يمكن تفعيله أو إزالة تفعيله 

٠‏ يكون الشكل التقليدي لهذا النمط عبارة عن مربع تظهر فيه إشارة × عند اختياره 

٠‏ عند إرسال النموذج يجري إرسال قيم العناصر المُختارة وهي قيم العناصر التي تظهر أمامها إشارة 
×. لذا يجب أخذ هذا الموضوع في الحسبان أثناء كتابة النص البرمجي الذي يعالج البيانات المُرسلة 

ه تعتمد القيمة التي يجري إرسالها في هذا النمط من الحقولء على القيمة المسندة للواصفة عu[ة۷‏ 

٠‏ يمكن تفعيل حقل التحقق تلقائياً عند إظهار النموذج وذلك عبر إضافة الواصفة ”لء)ءءط۳“ إلى 
التأشيرة. لا تأخذ الواصفة ”#ءاءءط٤“‏ أية قيمة ولكنء للالتزام بقواعد كتابة الواصفات» نسند لهذا النوع من 
الواصفات قيمة مساوية لإسم الواصفة وiكتبlq: Checked=” Checked”‏ 
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<input type=” checkbox” value=" test” name=”myCheck” 
Checked=”Checked” /> 


حقول النماذج: حقول الاختيار 
أزرار الراديو: 


ه يشبه شكل هذا النمط من الحقول» شكل خيارات قنوات الراديو حيث يمكن اختيار خيار واحد فقط من 
الحقول التي تنتمي إلى مجموعة واحدة 

ه تعتمد القيمة التي يعيدها النموذج» كما هي الحال مع مربعات التحقق»› على القيمة المُسندة للواصفة 
Value‏ 

يمكن تفعيل حقل التحقق تلقائياً عند إظهار النموذج وذلك عبر إضافة الواصفة ”١ء)ءءط)“‏ وإعطائها 
القيمة ”dء)ءع‏ ط٣“‏ كما هو الحال في حالة مربعات التحقق 


مثال: 
INOUE EYO rAd Mame Murad 10E vaUeE  OPEIOML EhCEKCEdG EM eEREAZ‏ 
EIESE ODEON DEZ‏ :/ 
cinpUE Eye lradliol name myRAGdI0 value ODEON /- SECON OOEION‏ 
CBE.‏ 
<InNpUE EVE rao Mane mMyRaAdI0 value ODE1GNNIL / EMIT ODEON‏ 


يظهر عند تنفيذ النص أعلاه النتيجة التاليةء حيث يجري إرسال القيمة ”«0نامه “f٣‏ وفقاً للاختيار المبين 
فى الشكل: 


f first option 
i second option 
f third option 


عناصر النماذج: حقول الاختيار 


قو ائم الاختيار: 


٠‏ تستخدم قوائم الاختيار التأشيرة <اءء1ع5> لإنشاء نمطين أساسيين من القوائم: 
0 القوائم المنسدلة 
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0 القوائم القابلة للزلق 
٠‏ يساعد كلا النوعين في تنفيذ عملية اختيار خيار واحد أو عدة خيارات من قائمة خيارات 

٠‏ يجري تحديد عناصر القائمة بالتأشيرة <«٥0نامه>‏ حيث يجري تضمين كل خيار ضمن القائمة 
باستخدام التآشیر <option></opti0n> ö‏ 

٠‏ يجري إرسال المتحول المُحدد يالواصفة #طةدء عند إرسال النموذج» محملاً بقيمة الخيار المحدد ب 
امه في حال قام المستخدم باختيار وحيد. أما في حالة الاختيار المتعددء فيجري تحميل متحول يمثل 
قائمة خيارات مفصولة عن بعضها البعض بفاصلة 

يكفي إضافة الواصفة عاما)اںص وإعطائها القيمة ”٥1م)‏ اا" لتحديد إمكانية استخدام عدة خيارات في 
قائمة الاختيار المعنية 

٠‏ يستطيع المستخدم» عند تفعيل خاصة الاختيار المتعددء اختيار أكثر من عنصر في القائمة بضغط زر 
R1‏ والنقر على الخيارات المطلوبة. أما في حال عدم تفعيل هذه الخاصة»ء فإن قوائم الاختيار تعمل بنفس 
الآلية التي تعمل بها أزرار الراديو حيث تسمح باختيار خيار واحد فقط من مجموعة خيارات 

٠‏ تتحكم قيمة الواصفة Sze‏ بارتفاع قائمة الاختيار القابلة للإنزلاقء وعندما تسند إلى هذه الواصفة 
القيمة ٠1”‏ يجري إظهار سطر واحد من القائمةء وتتحول هذه القائمة إلى قائمة منسدلة 

٠‏ لا توجد واصفة خاصة للتحكم بعرض قوائم الاختيار إنما تأخذ القائمة العرض اللازم لاحتواء الخيار 
صاحب العدد الأكبر من من المحارف 

٠‏ يجري تحديد خيار تلقائي أومجموعة من الخيارات التلقائية باستخدام الواصفة لع1ءءاعS‏ وبإعطاءها 
القيمة ”dعاءء1عS“»‏ وذلك ضمن التأشيرة ١0نامه‏ لكل خيار من الخيارات المعنية 

٠‏ يمكن إنشاء مجموعات فرعية من الخيارات ضمن قائمة الخيارات الواحدة وذلك باستخدام التأشيرة 


<Optgroup>‏ وحصرجميع خیارت المجموعة الفرعية ضمن هذه التأشيرة 


مثال: 
<select namê="sêéêlêct ">‏ 
<OPEOSEOUS label Syria‏ 
ODEON value Tl DamaSCUS< OPE OM‏ 
<OPEIoONn value "21 Ale OO<1OPE1ON>‏ 
<OopEION value lI Lat EakK1a</0PLION>‏ 
</OPEOEOUS >‏ 
<OBtGrFOuUD Llabel="Jorfdan">‏ 
<option value="4">Amman</option>‏ 
<option value="5">Alakaba</option>‏ 
LOPES OUSE‏ 
</select>‏ 
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[Damascus >| 


Lamasclus 


Ea 


Lattakia 


A4la kaba 


4lakaba 
حالة الو اصفة حالة الو أصفة‎ 
Size=1 Size=7 


عناصر النماذج: الأزرار 


هناك ثلاثة أنواع أساسية للأزرار التي يمكن إضافتها إلى نموذج : 
أزرار الإرسال وإعادة تأهيل النموذج: 


٠‏ يساعد زر الإرسال في إرسال بيانات النموذج إلى المخدم حتى تجري معالجتها عبر الملف المحدد في 
الواصفة ١٥1)ءA‏ الخاصة بالنموذج وذلك باستخدام الطريقة المحددة في الواصفة 04ط)ء× المرتبطة 
بالنموذج 

يستخدم هذا النمط الوسم لام١1‏ على أن يتم إسناد القيمة ”۲إ طں؟“ إلى الواصفة عمر) 

٠‏ يمكن استخدام التأشيرة ١0))٠ط‏ لتأدية نفس الوظيفة 


مذال: 


GIRNOUE EVO SUOMIE hame ECE Val 2 eI 


<BUEEONn EyOE <SUDMIE4 Nane test valle <myValluel>text O1 
BDUEEON< {DUE EON 


يودي زر إعادة تأهيل النموذج ٥ء۸‏ إلى إفراغ الحقول من جميع القيم التي تم إدخالها من قبل 
المستخدم دون إرسال أية بيانات إلى المخدم 

۰ یمکن استخدام التأشيرة اام ہ1 أو التأشيرة ١٥٤ااط‏ لتحديد زر من هذا النمط بشرط إسناد قيمة 
“Reset”‏ إلى الواصفة Type‏ 
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مذال: 


<input type=”reset” value=”reset”> 


أو 


<BUELONn Lye lresell text ON reSeE BULLONn </bDuUCLOnZ 


عناصر النماذج: الأزرار 
الأزرار من نمط صورة: 


٠‏ يستخدم هذا النوع من الأزرار بهدف إضفاء جمالية على النموذج عبر تمثيل زر الإرسال بصورة 
٠‏ يجري استعمال التأشيرة امد مع إسناد القيمة ”عع1a“‏ إلى الواصفة #مرآ 

٠‏ يجري تحديد ملف الصورة المُستخدمة بإسناد المسار النسبي أوالمطلق لملف الصورة على المخدم 
الواصفة ٤ا9‏ 


مثال: 


إلى 


Tn DUE EVE Image StE 41 ime S My Image. GAEL, 


عناصر النماذج: الأزرار 
الأزرار متعددة الأغراض: 


٠‏ يساعد هذا النمط في إنشاء أزرار ذات أغراض متعددة مختلفة عما أوردناه حتى الآن 
٠‏ يجري في هذا النمط من الأزرار استخدام الأحداث لتحديد الفعل ورد الفعل 


٠‏ تستلزم هذه الأزرار استخدام نص برمجي من جهة الزبون 


٠‏ تستخدم هذه الأزرار التأشيرة ٤نم"!‏ أو التأشيرة ١٥ا8‏ بعد إسناد القيمة 8٤0١‏ إلى الواصفة عمر) 


مثال: 
cinout EYe "OUEEONML‏ 
value "Please Dont Press INis BULEON‏ 
Onell Eek= WINGO. alert ( any Message. JL 1S‏ 

أو 

<button type="button™ 
value="anyValue" 
onclick="window.alert (any message.'")"> 'Please do not press 
ENIS DUCEON GAIAM </OULEON> 


ال ی و ای ھی ا ا ےک کے کو ی و کے E‏ 
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رسالة. ويكمن الاختلاف الرئيسي بين ١٥ااا8‏ و اام[ في أن التأشيرة ١٥))ں8‏ تأخذ قيمة النص الموجود 
على الزر من النص المحصور بالتأشيرةء أما في حالة التأشيرة ام1 فيتحدد النص الموجود على الزر بقيمة 
الواصفة عناه الخاصة بهذه التأشيرة. 


عناصر النماذج: الحقول المخفية 


الحقول المخفة: 
و ا ر کا کور ی کک و ا 


٠‏ يستخدم هذا النمط من الحقول عادة في حالتين: 

- لتمرير قيم إلى المخدم ليس لها أي دلالة للمستخدم» حيث يستفيد من هذه القيم النص البرمجي الذي 
يعالج المعطيات من جهة المخدم 

لتمرير معلومات يجب أن تبقى غير مرئية للمستخدم لأسباب تتعلق بسريتها. إذ يضمن إخفاء بعض 
المعلومات المُرسلة بهذه الطريقة حمايتها من المستخدم البسيط أو المبتداً 


٠‏ يستخدم هذا النمط من الحقول التأشيرة ام1 بعد إسناد القيمة ٥””‏ ل814“ إلى الواصفة ممرآ. أما 
القيمة التي يجري إرسالها عند إرسال النموذج» فهي القيمة المُسندة إلى الواصفة عuاه۷‏ 


مثال: 
<input type=” hidden” name=“myHidden” value=“value we want to hide”‏ 
1 
تكون أحد القيم التي تصل إلى المخدم» في حال جرى إرسال نموذج يحتوي النص أعلاه» هي القيمة: 
myHidden=value we want to hide‏ 


تمرين عام 


نريد إنشاء نموذج يعمل على جمع المحددة فيما يلي لإرسالها إلى ملف باسم ×م5ه.٣ع)ءاعه٣.‏ نفترض أن 
النموذج يمتلك الشكل التالي: 
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Login Name 
Password 
Full Name 
SEX 
Address 


any AaAûfdFE3a 


Email ski scs-net.org 


type of membership MASTER MEMBERSHIP ¥ 
picture File Browse... 


interested In 


other inter 


Subrnlt 


الحل: 
CC IDOCTEE HUM EVEL LCM CUD MI 4 Ol Trance IOONLLEN‏ 
"HEED: WWW WI. OEG/IRIREMLAZLlOOSE CEQA‏ 
CREM;‏ 
Me 2O‏ 
SELE le SIE SE ECEM /EN Ele‏ 
<meta NEEG eQUIvV-"CONECNE ype" Content lext/NEmMl; Charset =1s0‏ 
6 
<StEvVle EVDE TECEXE/ CSS‏ 
ا 
.Stylel {eolor: FEPEEBP)}‏ 
< 
SEVE‏ 
</head>‏ 
<BOdy>‏ 
FOLM acCElON rFeGI Stet .aSPxXl MmelNOd- BOSE CNCEVEE- MUlEIWaAFE/EOEM‏ 
data">‏ 
<Eaole WIdtN 19401 SOLdelL 121 CellC 0" CellLSSACINSG UL‏ 
bDoOrder COlOETHEBEEBENY‏ 
SEE>‏ 
SERN IGEN lO DICOIOE- I FO00000 SCOPE LOW CSA‏ 
class="stylel">Login Name</span></th>‏ 
Ed CoOlSpaAan l2l ARNE UE Mame lOO! EVE EeExXE! 14 llooIM cE‏ 
VEE‏ 
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CEE 

<R DOCOLOE-"F666666" SCOPE "EON" >5<SBan 

GlasS lStvyVlcellPASSWOEA</ Span >< CA> 

EGA COIS Ll CAROUE MAME OAS EVOC OAS SWOEdL 1G UAL CEG 
SEES 

SE > 

<En DIcCOoOloOE"HO666OCT SCEOBe rO ><SDanNn Class St vVlelL>EULL Name 
</span></th> 

<td colspan="2"><input name="ful1IName" type="text" 

10 EUNUNAMeE LE < EQAS 

IEE 

CEK > 

EN OOCOlIOE THOCC60600! SCOPE TON <SDAN 

Class Sty lel Sex SPAN C/E 

<td width="64"><input name="sex" type="radio" value="male"> 
male</td> 

<td width="81">=<input name="sex" typê="radio" vValue="radiobutton "> 
female</td> 

SEG, 

EE > 

<i COlSOaNn IN OICOlOEIFOO00600E SECEOBECE EOI >CSPAN 

Class Style l l> AddrteESS</SBaRn-</tEh> 

EES 

<iES> 

<th colspan="3" scope="row"><textarea name="address" cols="50" 
1d="textarea"></textarea></th> 

JEEZ 

SEK > 

GER OOCOLOE "FO00660! SESE EON <SPAN 

Class LSE le LLSEMALLS/ SPARS ER 

Ed Golspan Il 21<INOuUE Mame email ll EVE EEE 10 emall ll >< EO 
JEL 

GEE > 

<i OOCOlIOETHG66O0666T SCO eE- "rO S<SOaN Class Style ll>EVOeê OE 
membership</span></th> 

<td colspan="2"><select name="select"> 

<option>MASTER MEMBERSHIP</option> 

<option>NORMAL MEMBERSHIP</option> 

<option>GUEST MEMEBERSHIP</option> 

<select Ed 

VEE 

<iES> 

SEN OOCOlOE IFGOOOO06CE SEOMEeE "OW S<SOAN Class Style lIL SIGE UEE 


EIle</SPanz</ E> 

<td colspan="2"><input name="myPicture" type="file" id="myPicture" 
Size ION EA> 

JEEZ 

<IE> 

<EhN COlSARNR 31 DICOIlOE IHO00000 SCODE EON > <SBAN 

Class ISEvVlelIEInEereESEed 1N </SPaM> ERZ 

IEE 
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SEES 

<th colspan="3" scope="row"><select name="select2" size="5" 
multiple> 

ODE ION SPOKE 7 OBE TORN 

< ODE AOR ECOUCAE 1 ONC 7 ODEON 

< ODE 1 ON SNOOP NO #OPE1 ONS 

<OPILIONn GIRL S</OPE IO 

<OPDE1On -OENeE 1NtereSES</OBE1OM > 

<OPE 1O; </OPE LOR 
> 
</Select></Th> 

VES 

EES 

CER SeOPce= "EON CROSS; CLE 

<td colspan="2"><input type="reset" name="Submit2" value="Reset"> 
CiInNOUE EVO lSUDMIEL Mam: SUOMIENL value "SUOMIE L> </Ed> 

EES 

</table> 

EOE 

</DOOY> 

€ MEL 


الفصل الثالث - الجزء الأول 


عنوان الموضوع: 
طلب H11۴‏ باستخدام الطریقتينj GÊ_T ş POST‏ 


الكلمات المفتاحية: 
طلب» ترويسة» بروتوكول» إجابة/استجابة. 
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ملخض : 
یعتمد بروتوکول 1۲۲۶ على مجموعة من الطرق لإرسال طلبات 1۲۲۶ أهمها طريقتي آ٤6‏ و S1؟۴0.‏ سنغطي في هذه 
الجلسة بعض المعلومات العامة عن طلب برتوكول 31۲۲ وسنستعرض الفروقات الاساسية في استخدام كلا الطریقتین 6٤1‏ 
۾ .POST‏ 


أهداف تعليمية: 

يتعرف الطالب في هذا الفصل على: 

HTTP طلباٽت‎ . 

٠‏ طرق إرسال الطلبات 

٠‏ طريقتي 6٤1‏ و 081 و الشروط المثلى لاستعمالهما 


المخطط: 
المجموعات 
' 4 gyھدIژٽ (Learning Objects)‏ (عناو ين ال 10 بالترتيب المحدد) 


HTP POST 1.1.1‏ والطریقة P۲۲۲ G٤1‏ ]الطريقة 


ذكرنا في جلسة سابقة أثناء استعراضنا للتأشيرة “۴٥١٣۳١”‏ الواصفة ”١0ط٤۷6“‏ وبينا إمكانية إسناد إحدى 
القيمتين ”۶۴05۲“ أو “6٤1”‏ لهذه الواصفةء وذكرنا أن هذه الواصفة تحدد كيف سيجري إرسال البيانات أو 
الطريقة التي ستعتمد لإرسال طلب 1۲۲۲. 


لفهم الفرق بين هذين الطريقتین لا بد لنا من شرح بسيط لأجزاء طلب بروتوكول 317۲ . 


:H]' 1۲ البروتوکول‎ 

يعد البروتكول 1١۲۲‏ البروتوكول التطبيقي الأساسي المُستخدم لتناقل البيانات على شبكة الأنترنت. 

ويعتمد البروتوكول 11۲۶ آلية (طلب/استجابة) بين التطبيق الزبون (المتصفح) والتطبيق المخدم (مخدم 
الوب) 


:HT T° طلب‎ 
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تبداً مناقلة H۲7۶‏ بإرسال طلب .H]۲1۲°‏ 
يتکون طلب 1۲۴[ من مجموعة من الأجزاء كما يظهر في الشكل التالي. سنستعرض فيما يلي هذه الأجزاء 
ونحدد لأحقا نوع المعلومات التي يحملها كل جزء. 


GET / HETIP/1.1 
E Connection: lL Alive 


Accept: image/gif, image/x- 
xbitmap, image/jpeg, 


image/pjpeg, */* 
Accept=Languagêé: êRn-uüs 
Accept-Encodina: azipo,. 


Content-type:application/x- 
www~form-urlencoded 


Content-length:23 


Name=sami&type=3 


ةقیرطلاH‎ ۲٣۶P GET و‎ HTTP POST 
]لب‎ 


TTT 
تصن ]ا‎ | 


يتألف طلب 1۲۲۲ مما يلي: 


1. يتكون الجزء الأول من طلب p)ا‏ من العبارة »)Method URI HTTP/versi0)‏ الذي يطلب 
الصفحة من المخدم عبر مُعرّف المصدر )0۸R1(‏ باستخدام الطريقة ل0طا. يُمثل القسم الباقي من هذا 
الجزء من الطلب (الجزء )]1۲١۴/1.1‏ نسخة البروتوكول المستخدمة. 

2. يحتوي الجزء الثاني من الطلب الترويسة العامة ويحدد معلومات عامة كالتاريخ الحالي أو معلومات 
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خاصة كالاتصال الحالي. يُعد هذا الجزء غير إجباري بحيث يمكن أن يتم إرسال طلب 11۲1۲ من دون هذا 
الجزء. 

3. يحتوي الجزء الثالث الذي يدعى ترويسة الطلب على معلومات تتعلق بالزبون مرسل الطلب وبنمط 
البيانات المُرسَلة واسم المضيف. يعد هذا الجزء غير إجباري بحیث يمکن أن يتم إرسال طلب H11۲‏ من 
دون هذا الجزء. 

4. يستخدم الجزء الرابع الذي يدعى ترويسة الكيان» عند الشروع بإرساله وهو يحتوي معلومات تتعلق 
بنمط الكيان» وطوله» ومصدره وطريقة ترميزه. يكون هذا الجزء غير ضروري في حال عدم إرسال أي 
کیان . 


5. يمتل الجزء الأخير جسم الكيان ويحتوي القيم التي يقوم الطلب بإرسالها مثل قيمة حقل ما. 


POST yİ GET طريقة‎ 


بالعودة إلى مخطط الأجزاء المكونة لطلب 1۲١۲۴‏ نجد أنه يحتوي على الطريقة التي سيجري استخدامها في 
إرسال المعلومات. تأخذ هذه الطريقة إحدى القيمتين التاليتين: 


1 6: يجري طلب الوثيقة المحددة بالمحدد 10۸1ء ويجري إرسال بيانات المستخدم إلى العنوان المعين 
بالمحدد 0R]‏ ضمن الترويسة نفسها. 

1 : يجري طلب الوثيقة المحددة بالمحدد 11ء ويجري إرسال بيانات المستخدم إلى العنوان المعين 
بالمحدد R1‏ مع تضمين البيانات ضمن الجزء الخاص بجسم الكيان وليس في أي من الترويسات. 


تستخدم هاتان الطريقتان أثاء العمل مع نماذج 11× » كما يدعم البروتوکول 1۲۲۶ العديد من الطرق 


الأخرى نذكر منها: 
#050 : تتقدم بطلب مطابق للطلب الذي تتقدم به 681 ولكن الجواب على هذا الطلب يتكون من ترويسة 


دون أي جسم. تفيد هذه الطريقة في الحصول على المعلومات الموجودة في ترويسة الجواب 11۲۲۲ دون 
الحاجة إلى نقل كامل محتوى الجواب بما في ذلك نص الوثيقة التي يجري نقلها عادة عند الإجابة على الطلب. 
:E E1٤‏ تستخدم لحذف الوثيقة المُشار إليها بالمحدد 01 وهي نادرة الاستخدام. 

E‏ ف اران الطلت تهر ي (عادة فس الطاب انتما خت فكن الزبرن من مرف العاومات 
تي انها امات اتر سط إلى الطب ا مر آى تين بحسل على رى انف المردن. 
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0۴۲858 : تعيد قائمة بطرق 11۴[ التي يدعمها المخدم ويمكن استخدامها لاختبار عمل مخدم الوب. 


GET yi POST 


استخدام 681 لإرسال بيانات النموذج من الضروري مراعاة مايلي: 


5 


Problem loading page - Mozilla Firefox 


Fila Edit Yi aa EBnokmarks Tools Help 
4 - چ‎ - N 3 0 o 2 2 


® metting Started Bl Latest Headlines 


http: ffm, sk, cg kest ,aspx?name=Ahmadzjoh=rmanagê: 


© يجب ألا يكون حجم هذه البيانات كبيرا 
ف بح ا تحن لانت ار م قان اة 


تستخدم 6٤1‏ أيضاً بكثرة عندما تمرير قيمة معينة لملف عن طريق ارتباط تشعبي : 


a href=” test.asp 10 


أما الطريقة ۴051 فتستخدم لإرسال بيانات النموذج في حال: 

۰ اردنا إرسال بیانات بحجم بير نسبيا 

٠‏ إذا كانت المعلومات التي يتعامل معها النموذج حساسة 

بعد ان تعرفنا علی الفرق بین إرسال طلب H۲۲۴‏ باستخدام 6٤٣‏ وإرسال طلب 1۲۲۴P‏ باستخدام 


عند استخدام 6٤1‏ لإرسال بيانات النموذج من الضروري مراعاة مايلي: 

يجب ألا يكون حجم هذه البيانات كبيرأً نظراً لأنَ حجم البيانات الممكن إرسالها محدود بالحجم الأعظمي 
لمحدد المصدرء أي ال URL‏ 

٠‏ يجب ألا تحمل البيانات المُرسلة طابع السرّية لأن هذه البيانات ستكون مكشوفة وستظهر ضمن حيز 
عنوان المستعرض 


تشخ 68١‏ أيضاً بكشرة عندما تمرير قيمة معينة للف عن طريق راط تشعبي. قطلى سيل المقال: إذا 
أردنا تمرير القيمة 10=× إلى الملف ×مءه.اءم] عند النقر على وصلة ما ولتكن الوصلة ١١ط‏ kعناع»‏ تكون 
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الصيغة على الشكل التالي: 


أما الطريقة ۴0S1‏ فتستخدم لإرسال بيانات النموذج في حال: 

. أردنا إرسال بيانات بحجم كبير نسبيأً مثل ملف أو مربع نص يحتوي على حجم كبير من البيانات 
° إذا كانت المعلومات التي يتعامل معها النموذج حساسة بحيث لايمكن إظهارها ضمن حيز العنوان 
في المستعرض 


الجزء الثاني 
عنوان الموضوع: 
مقدمة إلى ۸SP.NE1‏ 


الكلمات المفتاحية: 
إطار عمل» بيئة تطوير» أدوات تطوير» تثبيت» معالج. 


ملخض : 
تعد ۸8۴.٤1‏ من التقنيات الرائدة في مجال النصوص البرمجية من جهة المخدم. سنتعرف في هذا الفصل على كيفية تيت 
إطار العمل الخاص بهذه التقنية بالإضافة إلى بيئة تطوير اعi0.1لS)u‏ ua1ء¡۷.‏ 


أهداف تعليمية: 

يتعرف الطالب في هذا الفصل على: 
ASP.NET jz Înan‏ 

. تتبيت إطار العمل اء. 


n 


Visual Studio.Net ٽıڊiت‎ ۰ 


ه٠‏ المزايا الرئيسية لتقنية ۸58۲.۴7 


مقدمة إلى النصوص البرمجية من جهة المخدم 
بwتخدlم ASP.NET‏ 
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سينصب تركيزنا فيمايلي على الحديث عن ۸8۴.٤1‏ كمثال عن أحد أهم التقنيات المعتمدة في كتابة النصوص البرمجية من 
جهة المخدم» كما سنتكلم عن ميزات هذه التقنية وعن تفاصيل استخدامها. 


تثبيت بيئة تطویر ٤1‏ ۸8۲.۸: 
عد تثبيت بيئة تطویر ۸8۴.۸8۳ سهل نسبيأً. إذ تتكون حزمة التشيت من ملف تنفيذي وحيد يقوم بتثبيت إطار العمل .٤۲‏ 
الذي يتضمن .۸5۴.٤1‏ ويقدم معالج التثبيت خيارات تتعلق بإمكانية تثبيت أمثلة تجريبية وملفات توثيق ..٤1‏ 


يمكن أن يطلب معالج التثبيت تحديث بعض مكونات ١ء]اهائم[‏ sسملمW1»‏ لا بد عندها من الموافقة على هذه الرسالة 
للاستمرار بعملية التثبيت» إذ يمكن أن تظهر شاشة حوار كما يلي: 


0 Microsoft NET Framework SDK {English} Setup 


The lolowing applic aliorls] were mat found on pou syeheme 
Microsoll Data Access Components ã7 


These applcalon|s] are recommended to be installed pio to furmirnig sep 
for serwe based applicalion:., 


Chek Ignore fo continues with lhe setup and Caneel lo gal lhe selup. 


تشير هذه النافذة إل ضرورة تثبيت مكون 2.7 «(4۸٥0‏ الذي يعتبر مكون غير إجباري» ولكن من الأفضل تتبيته لنتمكن من 
استخدام مزايا مختلفة تتعامل مع أدوات الوصول إلى قواعد البيانات ۸50. 


تثبیت بیئة تطویر E1۲ظASP.NE‏ 
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عند بدء التثبيت تظهر نافذة معالج التثبيت وهي على الشكل: 


Picrosoft NET Framework SDE {(FEnglish} Setup‏ ا 


2 ا‎ Install Options 


Microsoft 
lrcldez cemponents. fools, and samples necessary Io 
build and run .HET applications. 
٠ IY SDK Samples 
mı 


F# Eocimerkalar 


Daweloprment Infarmnalian for the Softwares 
Dayelapment Kit. 


4 Back Lanzel | Help | 


يقدم المعالج إمكانية تثبيت أدوات التطوير البرمجية إضافة إلى مجموعة من الأمثلة. 


في حال اختيار تثبيت الأمثلةء يجري تثبيت تلقائي لمكون 150٤‏ (محرك قاعدة بيانات مايكروسوفت) مع 
قاعدة بيانات تجرببية كجزء من الأمثلة. 


يبلغ حجم إطار عمل .٤١‏ فقط دون أي أمثلة 18ميغا بايت. 
تثبیت بينة تطویر ۸8۲.۸٤1‏ 


بيأ Visual Studio .NET‏ 
بالرغم من أن نیت .N٤1‏ oنلداء‏ سء¡ ليس شرطاً لازماً لكتابة وتشغيل ملفات ٤1‏ .۸8ء يصعب إهمال بيئة التطوير 
تلك لما تقدمه من مرونة عالية أثناء عملية التطوير وذلك من خلال واجهات استخدام عناصر التحكم» وآليات إزالة الأخطاء 

الناجمة عن بيئة التشغيل» وآليات التحسس الذكي لمفردات اللغةء بالإضافة إلى الكثير من الميزات الأخرى. 


:Visual Studio .NET تٽıبئت‎ 

يثبت معالج التثبيت في .N٤1٣‏ i0oلناS‏ امuء¡۷‏ مجموعة من المكونات التي تتضمن إطار عمل :.N٤1‏ 
ه نسخة 2.0 ۲عا1هاور1 M8‏ أو أي نسخة أحدث؛ 
¢‘MSFront page 2000 web Extention Client ةخui o‏ 
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ه ملفات التشغيل الخاصة بعملية تشيت البيئة؛ 

‘Internet Tools J| بالإضافغة‎ [Internet Exp|01er ه النسخة 6.00 من مستعرض‎ 

‘MS Data Access ja 2.7 ه مكونات النسخة‎ 

.Microsoft .NET Jae رlاط¦|إ‎ o 
ينفذ معالج التثبيت عملية التحقق من التحديثات المتوفرة في بيئة التشغيل بحيث يجري تثبيتها آليا بعد الحصول عليها عن‎ ٠ 
طريق الاتصال بالانترنت.‎ 


f vieual Shadîa.NET Setup 


Microsoft® 


EE Visual Studio.NET Setup 


Update 


Hy fterpeise Gre ekiprmrrd Taal 
A dJ NEI Framer k SDE 
A Bêj iryıtal Reşests lor Nisual heko NET 
FE I eais Tat Reds tHbuting Apec alan 
HER dj Serer Compenents 

Êy OL Server Orak Eegam 
E Rê boaımenkatisn 


Retaeê Dalaulta Hatt  lnîtallkaml Canil 3esen Can 


Visual Studio.net ٽيبiت‎ 


نظرا لطبيعة إطار عمل ٠.٤‏ لن يطلب المعالج تثبيت أدوات خاصة للتعامل مع لغات مختلفة كما هي الحال في النسخ القديمة 
من بيئة التطوير تلك» إذ يكفي تشغيل .N٤1‏ 0نلساء 1مسء۷i‏ واختيار اللغة التي سيجري استخدامها في البرمجةء ونوع 
التطبيق المراد إنشاؤه. يُسهل هذا الأسلوب على المطور استخدام بيئة العمل مع أي لغة من لغات إطار العمل .N٤1‏ دون 
الحاجة إلى التأقلم مع بيئة جديدة للعمل. 


اتد |مNET. :ASP.NET yJ Jaadl Visual Studio‏ 
لتطوير تطبيتlٽت Visual studio .NET مlIدختulب ASP.NET‏ كف„ lختıڼر ja ASP.NET WEB Application‏ 
خيارات نافذة )ءعزهإم سع.. تنشئ هذه العملية موقع وب مع بعض الصفحات التلقائية. من هذه النقطة يمكنك البدء باستخدام 

آلية اختيار عناصر التحكم المختلفة من واجهة التصميم. 


El f Bi Dok BA ekg Fame TEH Fit Fe Titi Him to 
ET O E ۰ ا‎ 
mols RE E E E: E OLLI TAT 
ims | 1 
Ee س‎ Praja Types: Temglahas: [ê ë| 
mm Î 1 
2 a E 4 
e E CJ Waal Cf Projects 5 M 
hee beurre I] Hazal C++ Projets windows hss lhrary _ Winelowws 
ıl arm O seluê and Detloyment Projets Agpiraton Czrtal Lhrary 
ered banl 1 1 | 3 UJ Other Projerts 
n, | Û Haa db Shins r 
TE laten . 8 ا‎ 
FP ort : ASP. RET Web Web Carrol 
a ۶ E Lary 
Î pake = 
F Gede 
$ erie _ Û Aprojesk for creating tn applcstion wth a Web ue irterfare 
35 Rel Alora لھ‎ 
a ETT ah ا‎ Î Mame: [Webappkatınl 
lal rem = EE سے س‎ 
a mam Û Lotter [hetpirfocaltast a] re.. 
ج‎ 9 
f] cerd ا‎ j ProER wil becreated ot tpi focahastWebappiceticnt. 
ا‎ 1 
RE EE 
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لن ندخل في التفاصيل الخاصة بالعمل على بيئة اعہ. ناء ua1ء¡۷‏ وسنرکز على تفصيلات عJa‏ نة ASP.NET‏ 
وصيغتها بغض النظر عن بيئة التطوير . 


ملاحظة: 
لا بد من التنويه أيضاً أن ۸8۶.٤1‏ تحتاجء كتقنية نصوص برمجية من جهة المخدم» إلى نثيت مخدم 118. 


alذ| ASP.NET‏ 
افتقرت نسخة ۸5۲ الأولى التي طورتها ا۴هءهإء1, بالرغم من كونها تجربة مميزة»ء إلى الكثير من عناصر المرونة. فما 


الذي يدفعنا لاختيار ۸8۴.٤1٣‏ كبيئة تطويروما هي النقاط الأساسية التي تجعل من هذه اللغة من أنسب اللغات لتطوير 
التطبيقات على الوب. 


. تعتمد لغة ۸8۴.٤1‏ على إمكانية استخدام النصوص البرمجية المعالجة أو معالجة النصوص البرمجية ولا تعتمد 
على استخدام مفسّر لتفسير النص البرمجي أثناء التنفيذ مما يجعل ۸8۲.٤1‏ متميزة من حيث الأداء؛ 

تقدم ۸5۴.N٤E1‏ إطار ذو فعالية عالية بأقل حجم ممكن للنص البرمجي؛ 

° يقدم إطار .N81‏ مجموعة من المكونات الخاصة بالتعامل مع التجهيزات المختلفة بما فيها الأجهزة الخلوية؛ 

° تقدم ۸8۶۴.۴٤1‏ من خلال دعمها لتقنيات ۷× و 1۷1[ بيئة تطوير متوافقة مع المعايير القياسية؛ 

. جرت إعادة تطوير ۸5۴.٤1‏ من الصفر مما ساعد على التخلص من أغلب الأخطاء والمشاكل التي احتوت 
عليها أسلافها. 

° تقدم ۸8۶.81 البيئة المناسبة لكتابة نص برمجي نظيف سهل الفهم. 

. تحسن ۸8۴.٤1‏ قابلية النقل» والتوسع» والأمان» والموثوقية. 

° تدعم إطار عمل ..٤١‏ العديد من لغات البرمجة مثل ۷8.٤1 »[# » ٤#‏ مما يجعل من الممكن تطوير عناصر 


تحكم أو مكونات بأي لغة من هذه اللغات وإعادة استخدامها ضمن .۸S8P۲P.N ٤1‏ 


نشاط 


نفذ عملية تثبيت kإمسعصه۴۲‏ 6۲. (يمكن لكل طالب أن ينفذها على جهازه أو أن ينفذها المشرف لمرة واحدة أمام الجميع) 
ااا علي مر اح شيت التالية. 


ه٠‏ ظهور نافذة التثبيت/التنصيب الأولى: 
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1 Misal Shdio, MET SEG 


Microsıo WE 


Visual Studio.NE I Setup 


Himoas Component Mpd ate 

SeîUp has datacted thaf serre of Tee Winmdoves corporates 
that are installed an your semputer da mat ruateh tha 

#ëFE RE Eq lë FoF Yesual ShIdie, HET. Foal Fie? lrFEtal|l ã 
dfferent tersiön GF Hese Windaris camipofearms 


Visual Studio. HËÎ 


TIO f 


SE lr E ReElEA 5 E 


Fear tHh2 


. يساعد برنامج التحديث على تثبيت مايلي: 
Windows 2000 Service Pack 2, if installing on Windows 2000.‏ 

Microsoft Windows Installer 2.0 

Microsoft FrontPage 2000 Web Extensions Client 

Setup Runtime Files 

Microsoft Internet Explorer 6.0 and Internet Tools (this requires a reboot) 

Microsoft Data Access Components 2.7 

Microsoft .NET Framework 


يمكن إدخال اسم مستخدم وكلمة مرور بحيث يجري استخدامهما عند إعادة الإقلاع أوتوماتيكياً مما يساعد على تنفيذ 
عملية التثبيت آليا دون الحاجة لتدخل المستخدم. 


ه٠‏ لتثبيت .٥‏ 0نفدا؟ اس۷1 نتبع نفس خطوات التثبيت التي كانت متبعة في النسخ السابقة: 
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Ser rosa win ral Shain eT Fnberporise Oe rrlaper elin - 


MISFIT 


Vsual Studio’ ‘NET 


iE terin MET Erterprise Deval 


Select ems le ina NTE” CtPiegars Eas Uisiea eit imial Û itl. HETA 
iain Hikim ET Et Er prise Dr Ele 1 


I HE Elermpelsê Berela Timirls O Fesixre dexoripi 

ERA Êr. FET Franuremrurks SDE Vrauall Sbadis HET E nlererise e velaper 

Io Ed Crystal BF pts for Yael irin „SF I Tre Enterprise O ê Yêl opa a diONn gu kNG mY ir aire 
a e a recs scary ha Address gor dermelogp marê namtls 

1 1 The mufa of prmîkıctê inchidmt 

E-ER ji Feqger Campanas: 


E HL Gewer Bek aj Eagar 


w sisal Sheds «NET Enterprise Festares , wi hip pra wide 
hadê Amalyrer and Visual Studio Anal year 


ised Space #52 2B) 
Fea ae =4 8] 


Hezlarê Bala zlta 


٠‏ عند الانتهاء من الخطوة السابقةء ترك للمستخدم خيار جعل المُنتج يعتد التحديث الآلي عبر الإنترنت عندما تظهر 


تحديتات جديدة. 


.0 لا تعتمد النسخة الحديثة على جعل المُستخدم يختار اللغة ومن ثم يُشغل الأداة الموافقةء وإنما يجري الآر إقلاع 
Studio .Net‏ امVisu‏ واختيار اللغة والتطبيق المُراد توليده مباشرة. 
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I sual Ci Projects 
E iaual CE Projets Class bry _ WArdems 
N Setup and Deployment Projects ا‎ E 


TH U) Other Projects 


| #isual mud Snlutioms 2 : Ê چ‎ 


E ASP.NET reb rab Careral 
servi Library 
ا‎ 


| projet hor treating anı appl with ã Web zer mêerface 
Hamre! iebÃppikakhsni ا‎ 
Lesa | tp gflocalhorî 3 Brits ıi 


Prafecl wil be cresled aî tpi localhost We bippkicatîonl'. 


_ E | « j] od |_| 


: Visual Studio.Net „û ۸S P.N¢† تولید تطبيقات‎ 

ەه لالذهاب إلى ع0اهنل tءعزهإ۴ New‏ (الظاهر في الشكل أعلاه) 
ASP.Net Web Application رlaüخlا o‏ 

ه يجري بناء موقع وب مع عدد من الصفحات التلقائية 


ه يمكن الآن اختيار أدوات التحكم وعناصر صفحات الوب من الواجهات المُتاحة فيما يلي: 
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Û kor "tepk lirî ' (i pr at‏ ا 
e elpplicatEen 1‏ | 
H1 - Î Belarn‏ 
Baremihyiniaiyh‏ ا 
hb ara‏ 
E‏ 
ebrconra‏ 
lelutgplcation ë .adsco‏ 


Balaltidl yekem Web, Û, eel 


Î 


عمليات تثبيت أخرى: 
:0DB€ .NET Data Provider‏ الذي يوفر إمكانية الوصول إلى سواقات .058€٣‏ 

.)۴ 2۸ الذي يوفر إمكانية تطوير مواقع تدعم تجهيزات نقالة (هواتف»‎ :Mobiاe‎ nternet Toolkit 
أدوات مُساعدة خاصة بالمتصفح.‎ :[nternet Explorer Web Controls 


O 


O 


O 


Tm 


Em fg a? N MAM Cel FEN Ta Fal Fama 
De rE RF [DBA o-oo c B.Q romn 
ج س‎ 


nba ”[ 


Celad 
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الفصل الرابع 


عنوان الموضوع: 
عناصر تحكم 11۷1 من جهة المخدم 


الكلمات المفتاحية: 


عنصر تحكم» جهة المخدم » وب» تأشيرة 


ملخض : 

قدمت ۸8۴.٤١‏ تقنيات مميزة تحقق تحكم أكبر بمكونات صفحة الوب. تعتبر عناصر التحكم من جهة المخدم من أهم تلك 
التقنيات. 

سنحاول خلال هذه الجلسة التعرف على جزء من هذه العناصر وهو عناصر تحكم H1 ML_‏ 


أهداف تعليمية: 
يتعرف الطالب في هذا الفصل على: 


ASP.NET ga قلاع‎ 


اا في لات ا ى م الخو ارم من س كووكر ن كن الات 
التالية تغطية تقنية ۸8۲.٤‏ على اعتبارها إحدى التقنيات الرائدة في هذا المجال. 


إعداد البيئة: 
لا بد لنا -حتى نتمكن من تشغيل النصوص البرمجية من جهة المخدم- من وضع ملفات النصوص البرمجية 
على المخدم ضمن المجلد ۲١١س‏ سس أو ضمن أحد المجلدات الافتراضية. 


لا بد أن نتأکد ا من: 
- تثبيت إطار العمل .NE٤1‏ 
- تیت مخدم وب 118 


- التأكد من إعطاء صلاحية التنفيذ للملفات ضمن المجلد الحاوي على ملفات ×۲ ۸8 
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مثال: صفحة ۸8۴.٤۲‏ بسيطة جدا 
لنبداً أو لا بصفحة ۸8۴.٤1‏ لا تحتوي أي أوامر ۸8۶.۸6٤‏ اي تحوي فقط تعلیمات M1‏ 1۲: 


<html> 

<head> 

</head> 

<body> 

<p> this is only a test that contain html.</p> 
</body> 

</html> 


يمكننا أن نحفظ هذا النص بلاحقة (×۸5۴.) ثم نقوم بتشغيله في المستعرض والوصول إليه باستخدام محدد 
المصدر القياسي الخاص به. 


لا يحوي النص في هذا المثال أي تعليمات ۸8۶.16۲ لتنفيذها وسيقوم هذا الملف بإظهار محتوى الصفحة 


اطلعنا في الجلسات الماضية على مفهوم النصوص البرمجية من جهة المخدم وسنحاول من خلال الجلسات 
التالية تغطية تقنية ١٤48S۴.Nعلى‏ اعتبارها أحد التقنيات الرائدة في هذا المجال. 


إعداد البيئة: 
لا بد لنا -حتى نتمكن من تشغيل النصوص البرمجية من جهة المخدم- من وضع ملفات النصوص البرمجية 
على المخدم ضمن المجلد ۲١0س‏ سس أو ضمن أحد المجلدات الافتراضية. 


لا بد أن نتأكد اا من: 


- تیت مخدم وب 118 


- التأكد من إعطاء صلاحية التنفيذ للملفات ضمن المجلد الحاوي على ملفات ×۲ ۸8 
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استخدام النصوص البرمجية في ۲۴.۸N ٤1‏ ۸8 


استخدام التأشير ة <% %> لحصر النص البرمجي الخاص ب .۸8۴.N٤٣‏ حیث جری اعتمادہ 
لضمان التو افقية مع نصوص ۸8۶۴ (سلف )4S۴.N ٤١‏ وله الشكل التالي: 


<% the code goes here %> 


اu٣ج٤ استخدام التأشيرة <امذإاء؟> الخاص ب ا۷١11 مع إسناد القيمة ١ع۷إءء إلى الواصفة‎ ٠ 
بحيث يصبح التركيب على الشكل التالي:‎ 


<script runat=server> 
The code goes here 
</script> 


ةلکشمA‎ S۶ 


عانت نسخة 458۴ء من نفس معاناة الكثير من تقنيات النصوص البرمجية من جهة المخدم» والتي تمثلت في 
عدم إمكانية فصل النص البرمجي عن سياق خر ج ا1۲ لذا كان لا بد دائما من وضع النص البرمجي 
في المكان الذي نريد إظهار الخرج فيه. 


مثال: 
<html>‏ 
<body bgcolor="yellow">‏ 
<center>‏ 
<h2>Hello W3Schools!</h2>‏ 
<P> <%oResponse.Write(now())% ></p>‏ 
</center>‏ 
</body>‏ 
</html>‏ 


نلاحظ أننا اضطررنا في هذا المثال إلى وضع النص البرمجي في النقطة التي نود إظهار الخرج فيها وهو في 
حالتنا الوقت والتاريخ. 
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عانت نسخة 458۴ء من نفس معاناة الكثير من تقنيات النصوص البرمجية من جهة المخدم» والتي تمثلت في 
عم إمكانية فصل النص البرمجي عن سياق خرج ا17 لذا كان لا بد داثماً من وضع النص البرمجي 
في المكان الذي نريد إظهار الخرج فيه. 


ما الإضافة التي قدمتها ۸S۲.‏ ؟ 


قدمت ۸8۶.٤1‏ حلا لمشكلة عدم إمكانية فصل النص البرمجي عن سياق الخرج» باعتمادها تقنية عناصر 
التحكم من طرف المخدم» أو ما يسمى بتقنية r01ئCo1 .Server‏ 


عناصر التحكم من جهة المخدم هي بالتعريف تأشيرات يمكن للمخدم فهمها والتعامل معها. 


تقدم 81 .N‏ ۸8۶ ثلاثة أنواع أساسية من عناصر التحكم من جهة المخدم: 

HTML p< عناص‎ .1 

2. عناصر تحكم الوب (و هي أنواع جديدة من الوسوم خاصة ب1٤ )۸SP۲.N‏ 
3. عناصر تحكم تساعد في التحقق من دخل المستخدم 


مركن ا اء ها تة وخا السات ية آم اضر اتك بن جهة التكم رضحا 
بأمثلة. ولكن قبل البدء بهذا السرد لابد من استعراض ولو بصورة سريعة مفهوم الأحداث في A۸8۶۴. ٤1‏ 
لأننا سنستخدمه في أغلب أمثلتنا. 

تعتمد الكثير من التقنيات البرمجية على ما يسمى البرمجة المقادة بالأحداث» وهي تعني أن أي نص برمجي 
يجري تنفيذه يجب أن يكون مرتبطا بحدث ما ويسمى هذا النص» النص البرمجي الخاص بمعالج الحدث. 


لذلك يتوجب على المبرمج» أثناء برمجته لتطبيقات الوب باستخدام لغة 48۴.٤٣‏ الانتباه إلى ضرورة 


وضع النصوص البرمجية ضمن التركيبة المناسبة لتقنية البرمجة المقادة بالأحداث والتي تعتمد على ربط 
الحدث مباشرة بمعالج الحدث. 
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الأحداث في ASP.NET‏ 


تعتمد الكثير من التقنيات البرمجية على ما يسمى البرمجة المقادة بالأحداث»ء وهي تعني أن أي نص برمجي 
يجري فيه يجب أن يكون مر قبطا بث ها ويسى هذا الل التضن البرمجي الكاص بمعالح الححت: 


لذلك يتو جب عل المبرمج» أثناء برمجته لتطبيقات الوب باستخدام لغة ASP.NET‏ الانتیاہ إلى ضرورة 
رضم لمر الرن كن أ ك ا 1 لرن اة ا كات راي فد عي 
é6‏ ف افش ارمح اقاس ساد ات 


تعتمد الكثير من التقنيات البرمجية على ما يسمى البرمجة المقادة بالأحداث» وهي تعني أن أي نص برمجي 
يجري تنفيذه يجب أن يكون مرتبطا بحدث ما ويسمى هذا النص» النص البرمجي الخاص بمعالج الحدث. 


لذلك يتوجب علی المبرمج» أثناء برمجته لتطبيقات الوب باستخدام لغة .ASP.NE1‏ الانتباہ إلى ضرورة 


وضع النصوص البرمجية ضمن التركيبة المناسبة لتقنية البرمجة المقادة بالأحداث والتي تعتمد على ربط 
الحدث مباشرة بمعالج الحدث. 
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أهم الأحداث التي تمر بها الصفحة من بداية عملها 


Page_Unload —ھ‎ Control Event Page_Load 


تأخذ معالجات الأحداث في ۸8۴.٤1‏ شكل الإجراءات الفرعية ويْعبّر عنها بالصيغة: 


Sub event_name 


Event_handling _code 
End sub 


عناصر تحكم ]1 من جهة المخدم 


تنحصر مسؤولية مخدم الوب في حالة تأشيرة 1٠ط‏ التقليدية التي تظهر ضمن ملف ۸8۲.٤٣‏ بتمرير هذه 
التأشيرة كنص عادي ليجري تفسيرها من قبل المستعرض ثم إظهار الناتج كصفحة وب. يختلف الحال مع 
عتاصر تحكم 17 من جهة المخدم حيث تعامل تلك العناصر كمكونات قايلة للبرمجة يقهمها المخده. 


لجعل تاشير 111-3 تعامل كعنصر تحكم؛ يكفي إضافة الراصفة افون لمذه التأشيرة واستاد القيمة 
آVER "SER‏ إليهاء وإعطاء قيمة للواصفة (10) بحيث يجري استخدامها لاحقاً من قبل المخدم كمُعرف 
اارضو ل ى تسر اتك اماق ك ككل قى لرك 


ملاحظة هامة: 

يجب أن تظهر جميع عناصر التحكم من جهة المخدم ضمن التأشيرة <صإإه؟> مع الانتباه إلى ضرورة اعتبار 
هذه التأشيرة عنصر تحكم» أي تزويدها بقيمة للواصفة ٤٠ن‏ وقيمة للواصفة 12ء وذلك لإعلام المخدم أن 
هذا النموذج يجب التعامل معه كنموذج من طرف المخدم» وأن العناصر المحصورة بهذا الوسم يمكن الوصول 
إليها من قبل النص البرمجي من جهة المخدم. 


مثال: 
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SEMIS 

<body> 

<form runat="server"> 

Ga EOLA LW CUDANE —W SO VOL VLISLE SK WESLE: 
TV E SEMIS 

</body> 


تم إعطاء القيمة "11«)1" للواصفة 10 الخاصة بهذا العنصر كما يظهر في النص البرمجي. 


بتمرير هذه ۸8۶.81 التقليدية التي تظهر ضمن ملف 1٠1إتنحصر‏ مسؤولية مخدم الوب في حالة تأشيرة 
التأشيرة كنص عادي ليجري تفسيرها من قبل المستعرض ثم إظهار الناتج كصفحة وب. يختلف الحال مع 
من جهة الخدم خيث تعامل لك العناصضر كمكونات فابلة ابر مجة يفهمها المخدم. ا10[ عتاضن تدك 


لجعل تأشيرة 111 تعامل كعنصر تحكم» يكفي إضافة الواصفة ٤ه«نإ‏ لهذه التأشيرة وإسناد القيمة 
آVER "SER‏ إليهاء وإعطاء قيمة للواصفة (10) بحيث يجري استخدامها لاحقاً من قبل المخدم كمُعرف 
اارضر ل ا کسر اکر ساق كه شل ساره 


من جهة المخدم 11 11عناصر تحكم 


بعد أن أوضحنا المبداً الأساسي لعناصر تحكم ا11۷ من جهة المخدم» سنقوم باستعراض أهم هذه العناصر 
وها | ت انا متاو انتا هذا السرد توضیح بعض الآليات التي تستخدم مع هذه العناصر من خلال 
الأمثلة. 


عنصر تحكم الارتباط التشعبıي :HTMLANCHOR‏ 
يعمل عنصر التحكم هذاء لإنشاء ارتباط تشعبي وهو يستخدم التأشيرة <4>. 
من أهم معاملات الغرض البرمجي الذي يمثل هذا العنصر : 


: TT 2 ATTRIBUTE 
تعيد قائمة بجميع واصفات هذا العنصر وقيمها‎ S 
قم نطف ته كرون هذا الخصر مف أ غر ى وها‎ 

DISABLED 
۳۴ا۴ للافتراضية هي‎ 
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HERF 


ID 


INNERHTML 


INNERTEXT 


NAME 


STYLE 


TARGET 


TITLE 


VISIBLE 


ONSERVERC 
LICK 


مثال: 
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اف سد ا التسر 


يقوم بتعيين أو إعادة النص المحدد بتأشيرتي فتح وإغلاق هذا 
ضر ر ع كول تارف لاص لى 
يقوم بتعيين أو إعادة النص المحدد بتأشيرتي فتح وإغلاق هذا 


اسم الارتباط 
التي سيجري تطبيقها على هذا العنصر 08S‏ يعيد خصائص 

اسم النافذة الهدف التي سيجري فتح محتوى الارتباط التشعبي فيها 
العنوان الذي سوف يظهر عند تحريك المؤشر فوق هذا الارتباط 
قيمة منطقية تحدد كون هذا العنصر مرئي أو لا 


اسم التابح الذي سيجري تنفيذه عند النقر على هذه الوصلة 


<script runat="server"> 

Sub Page_Load 
link1.HRef="http://www.google.com" 
link1.Target="_blank" 
link1.Title="google" 


link2.HRef="http://www.microsoft.com" 
link2.Target="_blank" 
link2.Title="Microsoft" 

End Sub 

</script> 


<html> 
<body> 


<form runat="server"> 
<a id="link1" runat="server">Visit google!</a> 
<br /> 
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| </form> 


</body> 
</html> 


سيقوم مثالنا بإنشاء وصلتين أحدهما لموقع «5١‏ والثاني لموقع ماع0مع . 
كما نلاحظ أن كتلة النص البرمجي تم فصلها عن سياق كتلة محتوى الصفحة حيث تم وضع التعليمات كجسم 
لمعالج الحدث ل2٥1_ءعه۴‏ في بداية المثال. 


تبدو بصورة واضحة آلية تعيين قيم الخصائص لعناصر التحكم من جهة المخدم. 


HTML pكحتلا عناصر‎ 
HTMLBUTTON pكحتلإ عنصر‎ 


يعمل عنصر التحكم هذا على إنشاء زر وهو يستخدم التأشيرة <١ه)ناط>.‏ من أهم معاملات الغرض الذي 


يمثل هذا العنصر: 


ATTRIBUTES 


DISABLED 


ID 


INNERHTML 


INNERTEXT 


ONSERVERCLI 
CK 


RUNAT 


STYLE 
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تعيد قائمة بجميع واصفات هذا العنصر وقيمها 


قيمة منطقية تحدد كون هذا العنصر مفعل أم غير مُفعل وقيمتها 
۴£ لافتراضية هي 


مُعرٴف وحيد لهذا العنصر 


يقوم بتعيين أو إعادة النص المحدد بتأشيرتي فتح وإغلاق هذا 
يقوم بتعيين أو إعادة النص المحدد بتأشيرتي فتح وإغلاق هذا 


اسم التابع الذي سيتم تنفيذه عند النقر على هذه الوصلة 
ويحدد أن عنصر التحكم من جهة المخدم ٥٣۷٥۲‏ 5يأخذ القيمة 
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VISIBLE‏ قيمة منطقية تحدد كون هذا العنصر مرئي أو لا 


مثال: 
سيْظهر هذا المتال زرين بلونيين مختلفين وسيظهر تعليق مختلف عند نقر كل زر من الزرين. 
نلاحظ أننا استخدمنا الأحداث التي تطلقها عناصر التحكم ولم نستخدم حدث تحميل الصفحة ل102ا_عع۲a:‏ 


Sub event_name (source as object , e as eventargs) 


End sub 
يكفي لربط حدث ما بمعالج حدث إعطاء قيمة اسم الحدث للواصفة عءناءام۷إعومه (في حالة مثالنا).‎ 


<script runat="server"> 

Sub button1(Source As Object, e As EventArgs) 
p1.InnerHtml="You clicked the blue button!" 

End Sub 

Sub button2(Source As Object, e As EventArgs) 
p1.InnerHtml="You clicked the pink button!" 

End Sub 

</script> 


<html> 
<body> 


<form runat="server"> 

<button id="b1" OnServerClick="button1" 
style="background-color: #e6e6fa; 
height=25;width: 100" runat="server"> 
Blue button! 

</button> 

<button id="b2" 
OnServerClick="button2" 
style="background-color: #fffOfS; 
height=25;width: 100" runat="server"> 
Pink button! 

</button> 

<p id="p1" runat="server" /> 

</form> 


</body> 
</html> 


عنصر لتحم HTMLFORM‏ 
يعمل عنصر التحكم هذا على إنشاء نموذج من جهة المخدم وهو يستخدم التأشيرة ٥۲۳<‏ ۴>. من أهم 
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المعاملات الخاصة بالغرض الذي يمثل هذا العنصر: 


اف الال دا 
ATTRIBUTES‏ تعيد قائمة بجميع الواصفات وقيمها. 
قيمة منطقية تحدد كون هذا العنصر مفعل أم غير مُفعٌل وقيمتها 
DISABLED‏ 
۴A٤‏ لافتراضية هي 
٠. ENCTYPE‏ mآM[]تتحدد‏ نمط تشفير البيانات حسب أنماط 
ID‏ مُعرّف وحيد لهذا العنصر 
يقوم بتعيين أو إعادة النص المحدد بتأشيرتي فتح وإغلاق هذا 
INNERHTML‏ 
يقوم بتعيين أو إعادة النص المحدد بتأشيرتي فتح وإغلاق هذا 
INNERTEXT‏ 
P۴1 METHOD‏ أو ۴۲ 6تحدد طریقة إرسال البيانات: 
NAME‏ اسم الارتباط 
RUNAT‏ ويحدد أن عنصر التحكم من جهة المخدم ۲٠۲۷ء‏ 5يأخذ القيمة 
STYLE‏ التي سيتم تطبيقها على هذا العنصر 08S‏ يعيد خصائص 
TARGET‏ اسم النافذة الهدف التي سيتم فتح محتوى الارتباط التشعبي فيها 
VISIBLE‏ قيمة منطقية تحدد كون هذا العنصر مرئي أو لا 


نص llتكp HTMLGENERIC‏ 
عنصر التحكم هذا يمكن استخدامه للتخاطب مع أي تأشيرة من جهة المخدم. من أهم معاملات الغرض الممثل 
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ATTRIBUTES‏ تعيد قائمة بجميع واصفات هذا العنصر وقيمها 

قيمة منطقية تحدد كون هذا العنصر مفعل أم غير مُفعل وقيمتها 
۴A £‏ لافتراضية هي 

ID‏ مُعرف وحيد لهذا العنصر 

يقوم بتعيين أو إعادة النص المحدد بتأشيرتي فتح وإغلاق هذا 


DISABLED 


INNERHTML 
يقوم بتعيين أو إعادة النص المحدد بتأشيرتي فتح وإغلاق هذا‎ 
INNERTEXT 
5يأخذ القيمة‎ ٥٣۷٠۲ ويحدد أن عنصر التحكم من جهة المخدم‎ RUNAT 
التي سيتم تطبيقها على هذا العنصر 088 يعيد خصائص‎ STYLE 
قيمة منطقية تحدد كون هذا العنصر مرئي أو لا‎ VISIBLE 
مثال:‎ 


نتعامل في المثال التالي مع التأشيرة <۴> على أنها عنصر تحكم من جهة المستخدم» وقد حددنا قيمة ال 10 
الخاص بهذا العنصر ثم جعلنا معالج حدث النقر على زر )أ٣‏ طں؟ يغير قيمة 1ہ :innerH‏ 


<script runat="server"> 
Sub submit(sender As Object, e as EventArgs) 
if name.value< >"" then 
p1.InnerHtml="Welcome " & name.value & "!" 
end if 
End Sub 
</script> 


<html> 
<body> 


<form runat="server"> 

Enter your name: <input id="name" type="text" size="30" runat="server" /> 
<br /><br /> 

<input type="submit" value="Submit" OnServerClick="submit" runat="server" /> 
<P id="p1" runat="server" /> 

</form> 


</body> 
</html> 


عنصر lلتحكp :HTMLIMA GE‏ 
يعمل عنصر التحكم هذا على إنشاء عنصر تحكم من جهة المخدم خاص بصورة وهو يستخدم التأشيرة 
<عصا>. من أهم معاملات الغرض الذي يمثل هذا العنصر : 
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ALIGN 


ALT 
ATTRIBUTES 
BORDER 


DISABLED 


HEIGHT 
ID 
RUNAT 
SRC 
STYLE 
VISIBLE 
WIDTH 


مثال: 


56 


تفده الكاصة اة الضرزة تة لى الكل الى تخ ها 
„right‏ eftا,‏ ottomط,‏ eاmidd,‏ pهtويمكن‏ أن تأخذ القيمة 
وصق بسيط للصورة 

د قاق بخ م و اصفات ها القضر رقا 

عرض الإطار. 

قيمة منطقية تحدد كون هذا العنصر مفعل أم غير مُفعّل وقيمتها 
۴£ لافتراضية هي 

ارتفاع الصورة 

مُعرأف وحيد لهذا العنصر 

ويحدد أن عنصر التحكم من جهة المخدم ٥۲۷٠۲‏ 5يأخذ القيمة 
محدد المصدر القياسي للصورة المراد إظهارها 

اک سك طا على هذا اضر 55 عد خان 
قيمة منطقية تحدد كون هذا العنصر مرئي أو لا 


عرض الصورة 


<script runat="server"> 
Sub choose_image(Sender As Object, e As EventArgs) 
image1.Src = select1.Value 


End Sub 
</script> 


<html> 
<body> 


<form runat="server"> 

<select id="select1" runat="server"> 
<option value="smiley.gif">Smiley</option> 
<option value="angry.gif"> Angry</option> 
<option value="stickman.gif"> Stickman </option> 


</select> 


<input type="submit" runat="server" value="Display image" 
OnServerClick="choose_image"> 
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| <img id="image1" src="smiley.gif" runat="server" width="32" height="32" /> 
</form> 


</body> 
</html> 


في هذا المثال سيجري تعديل الصورة التي يظهرها عنصر التحكم 1ءعع104 بحسب القيمة المحددة لعنصر 
التحکم <ion)اop>‏ . 


:HTMLInput p< عنصر‎ 


ATTRIBUTES‏ تعيد قائمة بجميع واصفات هذا العنصر وقيمها 
قيمة منطقية تحدد كون هذا العنصر مفعل أم غير مُفعٌل وقيمتها 
DISABLED‏ 
۴A‏ الافتراضية هي 
NAME‏ اسم الارتباط 
O OT ONSERVERCLI‏ 
CK‏ اسم التابع الذي سیدم ددویده علا النقر علی هده الوصلة 
RUNAT‏ ويحدد أن عنصر التحكم من جهة المخدم ٥٣۷٠۲‏ 5يأخذ القيمة 
STYLE‏ التي سيتم تطبيقها على هذا العنصر 08S‏ يعيد خصائص 
TYPE‏ ثفظ العتضر: 
VALUE‏ قيمة العنصر 
VISIBLE‏ قيمة منطقية تحدد كون هذا العنصر مرئي أو لا 
مثال: 


<script runat="server"> 

Sub submit(sender As Object, e as EventArgs) 

if name.value<>""'" then 
p1.InnerHtml="Welcome " & name.value & "!" 

end if 

End Sub 

</script> 


<html> 
<body> 


<form runat="server"> 

Enter your name: <input id="name" type="text" size="30" runat="server" /> 
<br /><br /> 

<input type="submit" value="Submit" OnServerClick="submit" runat="server" /> 
<p id="p1" runat="server" /> 

</form> 
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| </body> | 
| </html> 


استخدمنا في هذا المثال الإجرائية الفرعية انط طنء التي ستقوم باختبار القيمة ۷10# للحقل النصي 
عمصهہ. نلاحظ أننا قمنا باحتواء جميع عناصر تحكم ا۳ط ضمن الوسم <دإه؟>. 


4.و. مع#عنصر llت<كo :HTMLINPUTCIHECK BOX‏ 
ATTRIBUTES‏ تعيد قائمة بجميع واصفات هذا العنصر وقيمها 


CHECKED‏ قيمة منطقية تحدد كون العنصر قد تم اختياره أم لا 
© ف اط تحت كرون هاا اتر مقفل أ عر ل تتا 
۴A £‏ الافتراضية هي 
ID‏ مُعرف وحيد لهذا العنصر 
NAME‏ اسم الارتباط 
RUNAT‏ ويحدد أن عنصر التحكم من جهة المخدم ۲٠۷إ٥5يأخذ‏ القيمة 
STYLE‏ التي سيتم تطبيقها على هذا العنصر 08S‏ يعيد خصائص 
eT TYPE‏ 
VALUE‏ قيمة العنصر 
VISIBLE‏ قيمة منطقية تحدد كون هذا العنصر مرئي أو لا 


مثال: 


<script runat="server"> 
Sub submit(Source As Object, e As EventArgs) 
if red.Checked=True then 
p1.InnerHtml="You prefer red!" 
else 
p1.InnerHtml="You prefer blue!" 
end if 
red.checked=false 
blue.checked=false 
End Sub 
</script> 


<html> 

<body> 

<form runat="server"> 
What color do you prefer? 


<br /> 

<input id="red" type="checkbox" runat="server" /> Red 
<br /> 

<input id="blue" type="checkbox" runat="server" /> Blue 
<br /> 


<input type="button" value="Submit" OnServerClick="submit" runat="server"/> 
<p id="p1" runat="server" /> 
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</body> 
</html> 


HTMLINPUTHIDDEN pكaتll‎ رصiع‎ 


ATTRIBUTES‏ تعيد قائمة بجميع واصفات هذا العنصر وقيمها 


DISABLED‏ فة متطة فة كرن هذا الختضر مل أ غير شل ر قتا 
۴-۳٤‏ للافتراضية هي 
ID‏ مغرف وكة لهذا العتضر 
NAME‏ اسم الارتباط 
RUNAT‏ ويحدد أن عنصر التحكم من جهة المخدم ٣۷6۲‏ 5يأخذ القيمة 
STYLE‏ التي سيتم تطبيقها على هذا العنصر 0SS‏ يعيد خصائص 
TYPE‏ نوع العنصر 
VALUE‏ فة الف 
VISIBLE‏ قيمة منطقية تحدد كون هذا العنصر مرئي أو لا 


مثال: 


<script runat="server"> 

Sub submit(Source As Object, e As EventArgs) 
hidden1.Value=string1.Value 
p1.InnerHtml="Hidden value= " + hidden1.Value 

End Sub 

</script> 


<html> 
<body> 


<form runat="server"> 

Enter some text: <input id="string 1" type="text" size="25" runat="server" /> 
<input type="submit" value="Submit" OnServerClick="submit" runat="server" /> 
<input id="hidden1" type="hidden" runat="server" /> 

<p id="p1" runat="server" /> 

</form> 


</body> 
</html> 
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:HTMLINPUTIMA GE pكحتl عنصر‎ 


ALIGN‏ فخا الضورة 
ET‏ النص البديل 
ATTRIBUTES‏ تخد قائمة بج وأصفات ها الغنضر ,فعا 
BORDER‏ عرض الإطار الخاص بالصورة 
DISABLED‏ فة نطف فة كر ن ها العر مف ام غير ك رمتا 
۴A٤‏ الافتراضية هي 
ID‏ وة ها اضر 
NAME‏ اسم الارتباط 
ف اسم التابع الذي سيتم تنفيذه عند النقر على هذه الوصلة 
RUNAT‏ ويحدد أن عنصر التحكم من جهة المخدم ۲٠۷إ٥5يأخذ‏ القيمة 
SRC‏ محدد المصدر القياسي 
STYLE‏ التي سيتم تطبيقها على هذا العنصر 08S‏ يعيد خصائص 
TYPE‏ توغ لتر 
VALUE‏ لاض 
VISIBLE‏ قيمة منطقية تحدد كون هذا العنصر مرئي أو لا 


مثال: 


<script runat="server"> 

Sub button1(Source As Object, e As ImageClickEventArgs) 
p1.InnerHtml="You clicked the smiley button!" 

End Sub 

Sub button2(Source As Object, e As ImageClickEventArgs) 
pi1.InnerHtml="You clicked the angry button!" 

End Sub 

</script> 


<html> 
<body> 


<form runat="server"> 

<p>Click on one of the images:</p> 

<p> 

<input type="image" src="smiley.gif" 

OnServerClick="button1" runat="server" width="32" height='"32" /> 
</p> 

<p> 


Universal Knowledge Solutions s.a.1 60 


OnServerClick="button2" runat="server" width="32" height="32" /> 
</p> 

<p id="p1" runat="server" /> 

</form> 


</body> 
</html> 


نلاحظ في هذا الnثJl‏ wlتخدial‏ aillط imageClickEventArgs‏ ع عن النمط gs‏ ۲AمEv‏ أا 
رنت معا حت اتر على الضبورة: 


HTMLINPUTRADIOBUTTON oك<تl عنصر‎ 


5*^ | تعيد قائمة بجميع واصفات هذا العنصر وقيمها 
CHECKED‏ قيمة منطقية تحدد كون العنصر قد تم اختياره أم لا 
DISABLED‏ عة فة تكد كرن ها الحضر مل ام غير مل ةا 
۴۳۴ لافتراضية هي 
ID‏ مُعرّف وحيد لهذا العنصر 
NAME‏ اسم الارتباط 
RUNAT‏ ويحدد أن عنصر التحكم من جهة المخدم ٣۷6۲‏ 5يأخذ القيمة 
STYLE‏ التي سيتم تطبيقها على هذا العنصرS؟0Sيعيد‏ خصائص 
TYPE‏ نوع العنصر 
VALUE‏ فة اضر 
VISIBLE‏ قيمة منطقية تحدد كون هذا العنصر مرئي أو لا 


مثال: 


<script runat="server"> 
Sub submit(Source As Object, e As EventArgs) 
if r1.Checked=True then 
p1.InnerHtml="Your favorite color is red" 
else 
if r2.Checked=True then 
p1.InnerHtml="Your favorite color is green' 
else 
if r3.Checked= True then 
p1.InnerHtml="Your favorite color is blue' 
end if 
end if 
end if 
End Sub 
</script> 


<html> 
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<form runat="server"> 

<p>Select your favorite color: 

<br /> 

<input id="r1" name="col" type="radio" runat="server"> Red< /input> 
<br /> 

<input id="r2" name="col" type="radio" runat="server"> Green< /input> 
<br /> 

<input id="r3" name="col" type="radio" runat="server"> Blue< /input> 
<br /> 

<input type="button" value="Submit" OnServerClick="submit" runat="server"/> 
<p id="p1" runat="server" /> 

</form> 


</body> 
</html> 


HTMLINPUTTEXT pكaتll عنص‎ 


5^ تعيد قائمة بجميع واصفات هذا العنصر وقيمها 


DISABLED‏ قيمة منطقية تحذذ كرون هذا العنصر: مفعل آم غير مفعل وقيمتها 
£ ۴Aالافتراضية‏ هي 
8 مُعرآف وحيد لهذا العنصر 
MAX LENGHT‏ _ عدد المحارف الأقصى المسموح بإدخاله 
NAME‏ اا 
RUNAT‏ ويحدد أن عنصر التحكم من جهة المخدم ٣۷6۲‏ 5يأخذ القيمة 
SIZE‏ عرض الحقل النصي 
STYLE‏ التي سيتم تطبيقها على هذا 055 يحدد أو يعيد خصائص 
الفتضبر 
TYPE‏ نوع العنصر 
VALUE‏ قيمة العنصر 
VISIBLE‏ قيمة منطقية تحدد كون هذا العنصر مرئي أو لا 


HTMLSELECT pك<تll عنصر‎ 


SINET‏ تعيد قائمة بجميع واصفات هذا العنصر وقيمها 
P۳ MEMBFR‏ | اسم جدول البيانات المرتبط مع عنصر التحكہ 
DATASOURCE‏ ات مخذر الات اة 
E‏ الحقل المطلوب إظهاره من حقول مصدر البيانات ضمن 


Universal Knowledge Solutions s.a.1 62 


DATAVALUEFIE 
LD 


DISABLED 


ID 
INNERHTML 


INNERTEXT 


ITEMS 
MULTIPLE 


ONSERVERCHA 
NGE 


RUNAT 


SELECTEDINDE 
XxX 
SIZE 


STYLE 
VALUE 
VISIBLE 


مثال: 


63 


eT 

الحقل المرتبط بالقيم المتعلقة بالعنصر من حقول مصدر 
البيانات 
قيمة منطقية تحدد كون هذا العنصر مفعل أم غير مُفعّل 
۴5۴ر قيمتها الافتراضية هي 
مُعرف وحيد لهذا العنصر 
يقوم بتعيين أو إعادة النص المحدد بتأشيرتي فتح وإغلاق هذا 
۳1M‏ العنصر وهو لايقوم بتحويل المحارف الخاصة إلى 
يقوم بتعيين أو إعادة النص المحدد بتأشيرتي فتح وإغلاق هذا 
ای رفو کن كح الات اعا ن 
اا او ك ا 
تحدد إمكانية اختيار أكثر من عنصر من القائمة في نفس 
الوقت 

يجب تعيين هذه القيمة إلى اسم الإجرائية الفرعية التي تعالج 
كف اتير الكفن الخ من الفا 

ويحدد أن عنصر التحكم من جهة ١٥56۲۷يأخذ‏ القيمة 
ا 

الدليل وهو عدد صحيح يحدد العنصر الذي تم اختياره 

ار فاع قاشمة الأختار بش تسخها إلى الد 1 قي حال الر غد 
اء فة مف 

الت ست تباط هذا اشر 055ب خائ 
قيمة العنصر المختار 

قيمة منطقية تحدد كون هذا العنصر مرئي أو لا 


<script runat="server"> 
Sub choose_image(Sender As Object, e As EventArgs) 
image1.Src = select1.Value 


End Sub 
</script> 
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<body> 


<form runat="server"> 
<select id="select1" runat="server"> 

<option value="smiley.gif">Smiley</option> 

<option value="angry.gif"> Angry</option> 

<option value="stickman.gif"> Stickman </option> 
</select> 
<input type="submit" runat="server" value="Display image" 
OnServerClick="choose_image"> 
<br /><br /> 
<img id="image1" src="smiley.gif" runat="server" width="32" height="32" /> 
</form> 


</body> 
</html> 


HTMLTABLE pكحتلا عنصر‎ 


ALIGN‏ تحدد محاذاة الجدول 
ATTRIBUTES‏ تعيد قائمة بجميع واصفات هذا العنصر وقيمها 
BGCOLOR‏ كد ن اة 
BORDER‏ تحدد سماكة الإطار للجدول 


BORDERCOLOR‏ تحدد لون الإطار للجدول 


CELLSPACING‏ تحدد المسافة بين الخلايا. 


E E a DISABLED 
قيمتها الافتراضية هي‎ ر۴۸٤‎ 
TTT HEIGHT 
مُعرآف وحيد لهذا العنصر‎ ۴ 
يقوم بتعيين أو إعادة النص المحدد بتأشيرتي فتح وإغلاق هذا‎ DOT EINE 
العنصر وهو لايقوم بتحويل المحارف الخاصة إلى‎ 11M 
ا ا يقوم بتعيين أو إعادة النص المحدد بتأشيرتي فتح وإغلاق هذا‎ 
لعنصر وهو يقوم بتحويل المحارف الخاصة إلى‎ #1 
فاا يعيد مجموعة تحتوي جميع عناصر الصفوف الموجودة في‎ 
الجدول‎ 
RUNAT 


ويحدد أن عنصر التحكم من جهة ١٥56۲۷يأخذ‏ القيمة 
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STYLE 
VISIBLE 
WIDTH 


المخدم 
التي سيتم تطبيقها على هذا العنصر 08S‏ يعيد خصائص 
قيمة منطقية تحدد كون هذا العنصر مرئي أو لا 


تعيين عرض الجدول 


مثال: 
<script runat="server">‏ 
Sub submit(sender As Object, e As EventArgs)‏ 
dim i,j‏ 
table1.BGColor="yellow"‏ 
table1.BorderColor="red"‏ 
for i=0 To table1.Rows.Count-1‏ 
for j=0 To table1.Rows(i).Cells.Count-1‏ 
table1.Rows(i).Cells(j).InnerHtml="Row " & i‏ 
next‏ 
next‏ 
End Sub‏ 
</script>‏ 
<html>‏ 
<body>‏ 
<form runat="server">‏ 
<table id="table1" border="1" runat="server">‏ 
<tr>‏ 
<td>Cell 1</td>‏ 
<td>Cell 2</td>‏ 
</tr>‏ 
<tr>‏ 
<td>Cell 3</td>‏ 
<td>Cell 4</td>‏ 
</tr>‏ 
</table>‏ 
<br />‏ 
<input type="button" value="Change Contents" OnServerClick="submit" runat="server"/>‏ 
</form>‏ 
</body>‏ 
</html>‏ 
عنص llت<كp HTMLTABLECELL‏ 
ALIGN‏ المحاذاة للنص ضمن الخلية 
ATIRIBUTES‏ تعيد قائمة بجميع واصفات هذا العنصر وقيمها 
BGCOLOR‏ لون الخلفية 
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BORDERCOLOR‏ ون لطر 


COLSPAN‏ عدد الأعمدة التي يجب أن تستمر عليها الخلية 
DISABLED‏ فة اة تد كرون هذا الخصر مل آم غير شل 
٤۴5و‏ قيمتها الافتراضية هي 
HEIGHT‏ ارتفاع الخلية 
ID‏ مُعرف وحيد لهذا العنصر 
INNERHTML‏ 


يقوم بتعيين أو إعادة النص المحدد بتأشيرتي فتح وإغلاق هذا 
ر فر اک تل لحار ت الاس آل 


INNERTEXT‏ يقوم 3 پیر“ أو إعادة النص المخذد بتأشيرتي فتح ۳ غلا هذا 
ROWSPAN‏ عدد الصفوف التي يجب أن تستمر عليها الخلية 
N‏ ويحدد أن عنصر التحكم من جهة ١٠۲۷ء‏ 5يأخذ القيمة 
المخدم 
STYLE‏ التي سيتم تطبيقها على هذا العنصر 088 يعيد خصائص 
VALIGN‏ المحاذاة الشاقولية للعناصر في الخلية 
VBSIBLE‏ قيمة منطقية تحدد كون هذا العنصر مرئي أو لا 
WIDTH‏ عرض اة 
مثال : 


<script runat="server"> 

Sub submit(sender As Object, e As EventArgs) 
Dim row,numrows,numcells,j,i 

row=0 

numrows=rows1.Value 

numcells=cells1.Value 

for j=1 to numrows 

Dim r As New HtmlITableRow() 

rOW=rOW+1 

for i=1 to numcells 

Dim c As New Htm!ITableCell() 
c.Controls.Add(New LiteralControl("row " & j & ", cell " & i)) 
r.Cells.Add(c) 

next 

t1.Rows.Add(r) 

t1.Visible=true 

next 

End Sub 

</script> 


<html> 
<body> 
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<form runat="server"> 

<p>Table rows: 

<select id="rows1" runat="server"> 
<option value="1">1</option> 
<option value="2">2</option > 
<option value="3">3</option> 
</select> 

<br />Table cells: 

<select id="cells1" runat="server"> 
<option value="1">1</option> 
<option value="2">2</option > 
<option value="3">3</option > 
</select> 

<br /><br /> 

<input type="submit" value="Display Table" runat="server" OnServerClick="submit"> 


</p> 
<table id="t1" border="1" runat="server" visible="false'"/> 
</form> 
</body> 
</html> 
HTMLTABLERKO W pكحتلl عنصر‎ 
محاذاة العناصر ضمن السطر‎ ALIGN 
تعيد قائمة بجميع واصفات هذا العنصر وقيمها‎ ATTRIBUTES 
لون الخلفية‎ BGCOLOR 
لون الإطار‎ BORDERCOLOR 
يعيد الخلايا الموجودة ضمن هذا السطر‎ CELLS 
فا ت کون ها اسر مآ کو ا‎ DISABLED 
قيمتها الافتراضية هي‎ ر۴۸٤‎ 
ارتفاع السطر‎ HEIGHT 
فرت ود ليا لتر‎ 
يقوم بتعيين أو إعادة النص المحدد بتأشيرتي فتح وإغلاق هذا‎ INNERHTML 
ا1۲ العنصر وهو لايقوم بتحويل المحارف الخاصة إلى‎ 
يقوم بتعيين أو إعادة النص المحدد بتأشيرتي فتح وإغلاق هذا‎ INNERTIEAT 
ويحدد أن عنصر التحكم من جهة ١٠۲۷ء 5يأخذ القيمة‎ E 
المخدم‎ 
يعيد خصائص‎ 08S التي سيتم تطبيقها على هذا العنصر‎ E 
مخادذاة الاصر شاق ليا ضس المظر‎ VALIGN 
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VISIBLE 


ATTRIBUTES 


COLS 


DISABLED 


ID 


INNERHTML 


INNERTEXT 


NAME 


ONSERVERCHA 
NGE 


ROWS 


RUNAT 


STYLE 


VALUE 


VISIBLE 
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HTMLTEXTA REA pكحتلا عنصر‎ 


تعيد قائمة بجميع واصفات هذا العنصر وقيمها 

عرض مربع النص 

قيمة منطقية تحدد كون هذا العنصر مفعل أم غير مُفعَل 
۴A‏ قيمتها الافتراضية هي 

مُعرف وحيد لهذا العنصر 


يقوم بتعيين أو إعادة النص المحدد بتأشيرتي فتح وإغلاق هذا 
1 اسي ور و كر لمارف الخاة ل 
يقوم بتعيين أو إعادة النص المحدد بتأشيرتي فتح وإغلاق هذا 


اسم مربع النص 


اسم الإجرائية التي سيتم تنفيذها لمعالجة حدث التغيير على 
محتوى مربع النص 


ويحدد أن عنصر التحكم من جهة ١۴٥56۲۷يأخذ‏ القيمة 
المخدم 


التي سيتم تطبيقها على هذا العنصر 088 يعيد خصائص 


محتوى مربع النص 
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مثال: 


<script runat="server"> 

Sub submit(sender As Object, e As EventArgs) 
pi1.InnerHtml = "<b>You wrote:</b> " & textarea1.Value 

End Sub 

</script> 


<html> 
<body> 


<form runat="server"> 

Enter some text:<br /> 

<textarea id="textarea1" cols="35" rows="6" runat="server" /> 

<input type="submit" value="Submit" OnServerClick="submit" runat="server" /> 
<p id="p1" runat="server" /> 


</form> 
</body> 
</html> 
الفصل الخامس‎ 

عنوان الموضوع: 

عناصر تحكم نماذج الوب من جهة المخدم 

الكلمات المفتاحية: 

عنصر تحكم » جهة المخدم » وب » تأشيرة» خصائص » طرق» أحداث 

ملخض : 

قدمت ۸8۴.١‏ تقنيات مميزة تحقق تحكم أكبر بمكونات صفحة الوب. وتعتبر عناصر التحكم من جهة المخدم هي أهم تلك 

التقنيات. 


سنستعرض في هذه الجلسة مجموعة أخرى من عناصر التحكم من جهة المخدم نطلق عليها اسم عناصر تحكم نماذج الوب. 
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أهداف تعليمية: 

يتعرف الطالب في هذا الفصل على: 

٠‏ عناصر التحكم من جهة المخدم 

٠‏ خصائص عناصر التحكم من جهة المخدم 

٠ه‏ تفاصيل وأمتلة متنوعة حول عناصر تحكم عناصر تحكم الوب 


استعرضنا في الجلسة الماضية مجموعة من عناصر التحكم من جهة المخدم وأطلقنا عليها اسم عناصر تحكم 
.HTML‏ 


رأينا أن عناصر التحكم من جهة المخدم هي عناصر مترجمة ضمن الصفحة على المخدم» يمكن التفاعل 
معهاء» وتسمح بالانتقال إلى استخدام نقنية البرمجة المقادة بالاحداث مما يوفر بيئة تمكننا من كتابة نص برمجي 
وضو وق ا ال 


لاحظنا أيضاً أن عناصر تحكم ا١11‏ لم تكن إلا مكافئات من جهة المخدم لتأشيرات ا1۲ العادية والتي 
ما تزال تشكل آلية فعالة لإنشاء نماذج وصفحات تفاعلية . 


سنستعرض في هذه الجلسة مجموعة أخرى من عناصر التحكم من جهة المخدم نطلق عليها اسم عناصر تحكم 
نماذج الوب. 


عناصر تحكم نماذج وب 


المكافة M1‏ 1[عناصر عناصر تحكم نماذج 
وب 

<ASP:HyperLin <a>...</a> 

k> 

<ASP:LinkButt <a><img/></a> 

on> 

<ASP:Image> <img/> 

<ASP:Panel> <div>...</div> 
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<span>...</span> 
<input type="submit"/> or <input type=" button"/> 


<input type="text"/> أو‎ <input type=""password"/> أو‎ 
<textarea>...</textarea> 

<input type="checkbox"/> 

<input type="radio"/> 


<input type="image"/> 


<table>...</table> 
<tr>...</> 


<td>...</td> 


<ASP:Label> 
<ASP:Button> 
<ASP:TextBox 
> 


<ASP:CheckBo 
X> 
<ASP:RadioBut 
ton> 
<ASP:ImageBut 
ton> 
<ASP:Table> 
<ASP:TableRo 
W> 
<ASP:TableCell 
> 


هقد يبدو غريبا وجود مجموعة أخرى من عناصر تحكم نماذج الوب تقوم بعمل مشابه للعمل الذي تقوم به 


- تسهيل عملية بناء الأدوات والتطبيقات التي تولد تلقائياً واجهات المستخدم. 


- تسهيل عملية إنشاء نماذج وب بأقل قدر من المعرفة بطريقة عمل عناصر تحكم 1۲1 الأمر الذي 


دبعكس عناصر تحكم 11۷11[ تستخدم عناصر تحكم نماذج الوب أسماء موحدة لخصائصها التي لها نفس 
الدلالة. فعلى سبيل المثالء تمتل الخاصة 517۴ لعنصر تحكم ا١1۲1‏ المدعو ×180ء11 عدد الأسطر 
المرئية ضمن القائمة. بينما يصبح اسم هذه الخاصة ءاه٣‏ في عنصر تحكم 11۷1 آخر كالعنصر 
.TextArea‏ في حين تكون الخاصة WIDTH‏ التي تعبر عن عرض عنصر تحکم» موحدة في جمیع 


دليس هناك حاجة لأن يعرف المطور ما هو خرج ا۳11۷ اللازم لضبط الأبعاد والخصائص بالشكل 
المطلوب» إذ تقتصر مهمته على تعيين قيم الخصائص المرتبطة بعناصر نماذج الوب فقط. 


هتملك بعض عناصر نماذج الوب ميزات إضافية مساعدة مثل إضافة تلقائية للنص المرافق لمربع تحقق أو 


زر اختیار رادیو. 
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تقدم عناصر تحكم نماذج الوب العديد من الخصائص» والطرائق» والأحداث. نذكر منها تلك المشتركة 


خصائص وطر ائق وأحداث عناصر تحكم نماذج الوب 


الموروثة من نص :Webcontrols‏ 
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الوضفب 


إعادة جمیع الثنائيات (خاصة» قيمة الخاصة). 

يمكن استخدامها لقراءة الخصائص غير المعيارية (الخصائص التي لا 
) أر للرصول إلى - 11 شكل جز ءا من الترضيق المغياري الغة 
إعادة مفتاح الاختصار الذي يساعد غلئ اختیار العنصر. 

تحديد لون الخلفية. 

إعادة لون الإطار. 

إعادة نمط إطار العنصر (منقط »> مستمر ....(. 

إعادة سماكة الإطار. 

ASP.NET‏ إعادة قيمة معرف العنصر المعينة من قبل 

.إعادة عناصر التحكم (الأبناء) التابعة لعنصر التحكم الحالي (الأب) 
إعادة ما لذا كان العتصر مفغلا أ لا 


إعادة قيمة منطقية تحدد فيما إذا كان العنصر سيحافظ على قيمة 
لهذا العنصر ولجميع أبنائه. eأهءسع۷1المتغير‏ 


إعادة نو ع الخط 
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الفضاكى: 
والطرق» 
الأخاصة 

Attributes 


الخاصة 
AccessKey‏ 
الخاصة 
BackColor‏ 
الخاصة 
BorderColor‏ 
الخاصة 
BorderStyle‏ 
الخاصة 
BorderWidth‏ 
الخاصة 
ClientID‏ 
الخاصة 
Controls‏ 
الخاصة 
Enabled‏ 
الخاصة 
EnableViewS‏ 
tate‏ 
الخاصة 
Font‏ 


إعادة اللون المستخدم لمحتوى أو لنص عنصر التحكم 
إعادة ارتفاع العنصر. 

إعادة المعرف الخاص بعنصر التحكم هذا 

إعادة مؤشر إلى كائن الصفحة الحاوي على عنصر التحكم 


يعيد مؤشر إلى أب عنصر التحكم وفق التسلسل الهرمي لعلاقة عناصر 
ال < ۰ » کائن أ ۰ 2 
المطبقة على عنصر التحكم؟K8S‏ يمثل مجموعة جميع الأنماط 


إعادة تسلسل عنصر التحكم ضمن ترتيب انتقال الاختيار لدى ضغط 
۵٥‏ زر 

إعادة النص الذي يظهر لدى تحريك مؤشر الفأرة فوق عنصر التحكم. 
إعادة قيمة منطقية تحدد إخفاء أو إظهار عنصر التحكم في خرج 
الصفحة. 

تفعيل الربط بمصدر البيانات في عنصر التحكم وفي جميع أبنائه. 
إعادة عرض عنصر التحكم. 

إعادة قيمة منطقية تحدد فيما إذا كان لعنصر التحكم عناصر تحكم 


ايتا 


خصائص » طرق وأحداث عناصر تحكم نماذج الوب 
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الخاصة 
ForeColor‏ 
الخاصة 
Height‏ 
الخاصة 
ID‏ 
الخاصة 
Page‏ 
الخاصة 
Parent‏ 


الخاصة 

Style 

الخاصة 
TabIndex‏ 


الخاصة 
ToolTip‏ 
الخاصة 
Visible‏ 
الطريقة 
DataBind‏ 
الخاصة 
Width‏ 
الطريقة 
FindControl‏ 
الطريقة 
HasControls‏ 
الحدث 
DataBinding‏ 


تملك عناصر تحكم الوب طرائثقها وخصائصها المميزة إضافة إلى تلك التي ترثها. فيما يلي سرد لبعض أهم 


خصائص وطر ائق وأحداث عناصر تحكم نماذج الوب 


تلك الطرائق والخصائص بحسب عناصر التحكم. 
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OnClick, 
OnComm 
and 


OnClick, 
OnComm 
and 


OnTextC 
hanged 


OnCheck 
Changed 
OnCheck 
Changed 


OnClick, 
OnComm 
and 


ImageUrl, NavigateUrl, Target, Text 


CommandArgument, CommandName, 
Text, Causes Validation 


Alternate Text, ImageAlign, ImageUrl 
BackImageUrl, HorizontalAlign, Wrap 
Text 


CommandArgument, CommandName, 
Text, Causes Validation 


AutoPostBack, Columns, MaxLength, 
ReadOnly, Rows, Text, TextMode, 
Wrap 


AutoPostBack, Checked, Text, TextAlign 


AutoPostBack, Checked, GroupName, 
Text, TextAlign 


CommandArgument, CommandName, 
Causes Validation 


BackImageUrl, CellPadding, CellSpacing, 
GridLines, 
HorizontalAlign, Rows 


Cells, HorizontalAlign, VerticalAlign 


ColumnSpan, HorizontalAlign, RowSpan, 
Text, VerticalAlign, Wrap 
Text 
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HyperLin 
k 


LinkButto 
n 


Image 
Panel 
Label 


Button 


TextBox 
CheckBo 
Xx 


RadioButt 
on 


ImageBut 
ton 


Table 


TableRo 
W 


TableCell 


Literal 
PlaceHol 
der 


تملك عناصر تحكم الوب طرائقها وخصائصها المميزة إضافة إلى تلك التي ترثها. نجد في الجدول الرفق 
سرد لبعض أهم تلك الطرائق والخصائص بحسب عناصر التحكم. 


عناصر تحکم نماذج الوب 
مثال 1: 
نلاحظ في المثال التالي التشابه الواضح بين طريفة التعامل مع عناصر تحکم HHL‏ وطريقة التعامل مع 
عناصر تحکم نماذج الوب»› فقد قمنا بإنشاء زر بمعرف ))0١1‏ 1ط وقمنا بكتابة معالج الحدث الناتج عن 
ضغطه» بشکل منفصل»› في بداية المثال: 
<script runat="server">‏ 
Sub submit(Source As Object, e As EventArgs)‏ 
button1.Text="You clicked me!"‏ 


End Sub 
</script> 


<html> 
<body> 


<form runat="server"> 
<asp:Button id="button1" Text="Click me!" runat="server" OnClick="submit"/> 
</form> 


</body> 
</html> 


مثال 2: 

يتناول مثالنا الثاني عنصر تحكم الارتباط التشعبي» حيث نلاحظ أننا قمنا بتحديد صورة خاصة بالارتباط 
بالإضافة إلى نص» وقمنا بتعيين المحدد المصدري القياسي )0۸R1(‏ الذي يعرف الإرتباط والنافذة التي 
سيجري فتح الارتباط فيها. 


<html> 
<body> 


<form runat="server"> 

<asp:HyperLink ImageUrl="myImage.jpg" NavigateUrl="http://www.sk-www.com" 
Text="Visit sk!" Target="_blank" runat="server" /> 

</form> 

</body> 

</html> 


هناك تشابه واضح بين طريقة التعامل مع عناصر تحكم نماذج الوب وطريقة التعامل مع عناصر تحكم 
-ا۲M.‏ توضح الأمثلة المرافقة آلية وصيغة استخدام هذه العناصر. 
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خصائص عناصر تحكم نماذج الوب 
الاختلاف في قيم الخصائص 


بيز اننتخذام عناصر تكم ا17۷ بالسهرلة تظرا لأن ق الخصاتض تقتضر كى سال محارق كنا 
هو الحال في تأشيرات ۲1۷1 العادية. 


يختلف الحال مع عناصر تحكم نماذج الوب إذ يمكن أن تكون هذه القيم عبارة عن أغراض أو عن قيم مُرقمة 
(۵عEnumer).‏ فعلى سبيل المثالء نكتب عند محاذاة صورة إلى الجهة اليمنى لعنصر تحكم نموذج وب 
خاص بصورةَ: 

CASE E MACE SEC=VMVOLE OGLE IMACEAL LOR ELGOEY CUMA =FEOCTELY 7>‏ 
يجري إعطاء قيمة للعنصر عR1.١ع1‏ ۸41ء142 حيث يعرف العنصر عن طريق اسم الخاصة الترميز 


الذي يجب استخدامه. 


أما إذا رغبنا بتعيين القيمة أثناء تنفيذ النص البرمجي» فيجب إضافة هذا السطر ضمن النص التنفيذي في 


objMy Image. ImageAlign ImageAlign.Right 


objMyImage. ImageAlign = 2 


يساعد الغرض ١٥ام1إ٥ءە(عمرآ‏ على معرفة أسماء العناصر المُرقمة وذلك بعد استخدام ٤0۲م‏ "1 للربط 
مع ال ععجميوعمmهجN‏ المناسب. 


<$@Import Namespace="System.ComponentModel" %> 
TypeDescriptor.GetConverter (GetType (HorizontalAlign) ).ConvertFromSt 
aime (Me E) 


أو نستطيع استخدام التحويل المباشر باستعمال : 


Dim intValue = CType(HorizontalAlign.Left, Integer) 


بثمیز استخدام عناصر تحكم ا11 بالسهولة تظرا لأن قيم الخصاتص تقتصر لی سااسل محارف كما 
هو الحال في تأشيرات ۳1۷1 العادية. 


يختلف الحال مع عناصر تحكم نماذج الوب إذ يمكن أن تكون هذه القيم عبارة عن أغراض أو عن قيم مُرقمة 
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.(Enumerated) 
خصائص عناصر تحكم نماذج الوب‎ 


يمكننا أيضاً ببساطة استخدام الأداة W1٥۷‏ من إطار عمل €1 لتحديد القيم الُستخجمة في ترقيم 


| ا‎ Swale. Web. LT. WebControl, Hurîzonl alAlign = Class Viewer 


ڪڪ 
ودا داع اة Saarih Resuls‏ 
FON MOTE "E? \WFARF\ AI FAD IY \ FAL \ FE TOR RDN, O. 22‏ 


public enum Sys tem. Web. UI. WebCantro1s . ‘Hor zontal Al 1 qf 
[ 


te fah tro Center = ûxÛ0000002 , 
E Justify = Ox O0000004, 
EF Hatlzont allan miei Sytem. rds. For Left = ûxûûûûûûûî , 
NOTSEE = OxDOOODOOO, 
RIANT = CNOOQOOOOS , 
} y7 end OF SyYITEM. WED. UT. HESTCOAtFETS . HEOFTFOPFaAIAT IgA 


حيث يكفي البحث بجزء من الاسم عن الخاصة ثم الضغط في الجزء الأيسر على الخاصة المطلوبة للحصول 
على القيم المتاحة لها. 


هذا بالنسبة للخاصة المُرقمة ولكن ماذا بشأن الخاصة التي تشير إلى غرض. 


لنأخذ حالة قد تبدو للوهلة الأولى بديهيةء وهي حالة إسناد لون معين إلى أحد الخصائص ,010۲ 8ac)٤C‏ 
.FreC010r, BorderColor)‏ قد لا نحتاج إذا كنا نريد ضبط قيمة اللون إلى أكثر من إعطاء قيمة اللون 
مباشرة: 


<A E LEE Ox 10 MIE lY TELS NIMIS 18 A LEXTOOY EUMAL= EOE VOR 
BACK COLO = EEG Y RFOCECOLOSE =A EON 7> 


كما يمكننا تعريف غرض لون ومن تم إسناده إلى خاصة اللون. 
يمكننا أيضاً ببساطة استخدام الأداة ۷1,٤۷‏ من إطار عمل .NN E١‏ لتحديد القيم المُستخجمة في ترقيم 
الشتاضر 
خصائص عناصر نماذج الوب 
نص System.Drwaing.Color‏ 
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يعرف صف C0101‏ خصائص لجميع White «Antique «AliceBlue Jia) ةxسlıتll HTML jll‏ ( 
إضافة إلى توفير مجموعة من الطرائق لإنشاء غرض خاص باللون: 


تقزم انشا لون من كال مر كته الشففة إسافة لى ااأححن FromArgb‏ 
والأخضر والأزرق. 
قرم بانشاء كائن. لون من اسم اللرن رفا اللدميات المعتمدة فن FromKnownCol‏ 
HTML‏ ٍ 
تقوم بإنشاء كائن لون من القيمة الستة عشرية للون بنفس الطريقة FromName‏ 
1TM‏ المتبعة في 
مثال: 


<$@GImport Namespace="System.Drawing" %> 
MyControl.BackColor = Color.FromName (“ffO00007”) 


( White «Antique «AliceBlue Ja) ةılall‎ HTML jll خصائص لجميع‎ )٥010١ يعرف صف‎ 


إضافة إلى توفير مجموعة من الطرائق لإنشاء غرض خاص باللون: 


خصائص عناصر تحكم نماذج الوب 
صف 11٤‏ € الخاص بواحدات القیاس 


Width «Border «Height «Width 
: فكما نلاحظ في هذا المثال قمنا باستخدام % و ×۴ للدلالة على وحدة القياس‎ 


ASO E 1MAGE 1EM IMEIAGEY SEES MYOLE. GILES EUNAL=N Ser vO 
ELE AE = 1 OOo MIAME 5 


إضافة إلى هذه الطريقة يمكننا | ستخدام الطرائق وا لأخصائص التي يزودها الصف لإعطاء قيم أشاء عمل 
راا 


يكون الصف ا11 جزء من فضاء الأسماء الخاص بعناصر تحكم نماذج وب لذلك لا داعي لاستيراده لأشه 
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سیکون مستورد مسبقا. 


يمنح صف ا11 الخصائص والطرق التالية: 


تحدد نوع الوحدة المستخدمة يمكن أن تأخذ مما الخاصية 
إا ن اا ي 
Cm,Mm,Em,Ex,Inch,Percentage,‏ 
Pica,Pixel,Point‏ 

عدد الوحدات ueا۷aالخاصية‏ 

من النمط اا« لآتقوم بإنشاء كائن Percentageالطریقة‏ 
Percentage‏ 

1٥×ا۴‏ من النمط نہ تقوم بإنشاء کائن P1×e1الطريقة‏ 

ةقيرطلاPاn من النمط 11ہ آاتقوم بإنشاء کائن‎ Pn 

مثال: 


MyControl.Height=Unit.Pixel (50) 


في المثالء يمتل العدد 50 قيمة ارتفاع العنصر مقدرة بالبكسل. 


. Width «Border «Height «Width 


خصائص عناصر تحكم نماذج الوب 
lئخlصة AutoPostBack‏ 


عند بناء نموذج تفاعلي» يلزمنا في العديد من الحالات تفعيل عملية إرسال النموذج لدى اختيار عضصر من 
قائمة أو تفعيل مربع اختيار» بحيث يُسمح للمخدم بتحديث الصفحة عند الاستجابة لخيارات المستخدم. 


كانت هذه العملية تتم سابقاً (في 48۶) بواسطة حدث من جهة الزبون مرتبط بحدث اختيار أو تعديل حالة 
كحدث ء12۸٣0‏ كما في النص: 
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<script language="javascript"> 

<1 -- 

function _ doPostBack (eventTarget, eventArgument) { 
valê EME HORM — COCUMEE CEE O, 
tLheform.___EVENTTARGET.value = eventTarget; 
Lheform.___EVENTARGUMENT.value = eventArgument ; 

Ee OEM SUOMI E 

} 

GI MOU LEOSUVCONCEOLY Tvoe=EeheclklooxY maie =MYCOANEEOL# 


ORCLALECK= N AVASEE LOE F£__COPOSEBAECK ( MyContEOL TT, YH > 
CLAS Looe meme EVONIIAREETY value 1> 
GIRO EOCENE Meme _ EVEMNTARECUMENLY value= 7> 
n 


أُما في N٤٣‏ .۸8۴ فيكفي إسناد القيمة ١٠٠‏ إلى الخاصة )ءة18ء١ A0۴‏ حتى يجري إرسال الصفحة 
کے الیک س لفل ع ر ا ا ی دن اا ل 


:AutoPostBack ةيصlخll‎ 


عند بناء نموذج تفاعلي يلزمنا في العديد من الحالات تفعيل عملية إرسال للنموذج لدى الاختيار عنصر من 
قائمة مثلاً أو تفعيل مربع اختيار مما يسمح للمخدم بتحديث الصفحة لدى الاستجابة لخيارات المستخدم. 

في ۸8۴.N٤٣‏ يكفي تعيين قيمة الخاصية )ء8٥٥٥۸‏ إلى القيمة ٣٠٠‏ فسيتم إرسال الصفحة إلى 
المخدم بعد كل تعديل على عنصر التحكم الذي تم تعيين قيمة هذه الخاصية له إلى عuآ1.‏ 


خصائص عناصر تحكم نماذج الوب 
llخlاص ASP.NET aii Enable ViewState‏ 


يضطر عادة المستخدم إلى إعادة ملء محتوى نموذج مجددا بعد اختفاء عناصره نتيجة الخطاً في ملء أحد 
المعلومات. وقد كانت هذه الصفة مرافقة للعمل على نسخة 45۴ إذ كانت قيم عناصر النموذج تختفي بعد 
إرساله وكان لا بد للمبرمج من كتابة نص برمجي لمعالجة هذه الحالة. 


أُما في ۸5۲.٤٣‏ فيكون الإبقاء على محتوى النموذج مُفعّل بصورة تلقائية ما لم يحدد المبرمج إلغاءه 
بصورة قسرية ضمن الصفحة بالعبارة: 


<54 Page EnableVviewState="false" %> 
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يجب وضع هذه العبارة في بداية صفحة ۸8۲.6٤‏ أو يمكن إيقاف هذه الخاصة لأحد العناصر فقط بتحديد 
Enable ViewState=" false"‏ لهذا العنصر فقط. یمکن ان نستخدم ذه اة ماد عندما نتكلم عن حقل 


مخصص لإدخال كلمة سر. 


مثال : 


<script runat="server"> 

Sub submit (sender As Object, e As EventArgs) 
IbII.TEeXT="RellG " € TSLl. TEST CE I 

End SUB 

GJOCELOLES 


SEM 
Boyz 


<form runat="server"> 

Your name: <asp: TextBox 1d="txtl" runat="server" 
EnableViewState="false" /> 

CASO? BUE EO ONCLALEkK=FEuOmMLEY Text SIUM EY EUNAL=V SE vVELY /5 
COSA: AOE L ENOL LY CUNIC="SECTEENY 5<7 


€ / FOES 


€ f/IOOIVS 
Eme 


يضطر غادة المستخذم إلى إعادة ملء محتوى تموذج مجددا بعد اخثفاء غناصره نتيجة الخطاً في ملء أحد 
المعلومات. وقد كانت هذه الصفة مرافقة للعمل على نسخة 48۴ إذ كانت قيم عناصر النموذج تختفي بعد 
إرساله وكان لابه للميرمج من كقابة تص بر مج لمغالجة هذه الحالة. 


أما في ۸8۴.٤1‏ فيكون الإبقاء على محتوى النموذج مُفعّل بصورة تلقائية ما لم يحدد المبرمج إلغاءه 


بصورة قسرية ضمن الصفحة. 
مثال 


في المثال التالي استخدمنا عنصر تحكم نموذج وب أء80×[1عءعطء حيث نلاحظ تفعيل الخاصة 
.Autopost Back‏ سيقوم هذا البرنامج عند كل نقرة على أي عنصر من عناصر القائمة بإضافة اسم العنصر 
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إذا كان مُفعَلاء على قيمة النص الخاص باللصاقة كوعص 


SSEEIOE FUMaAE— Sel VEE LS 
Sub Check (sender As Object, e As EventArgs) 
CLM 1 
MESS E E= NTIS SELECEEGM TECM(S) : <O 
LOE i=U TEGO cCheckl.ILems.Count=—l 
1f check1.Items(i).Selected then 
IES S , EE + =eeelkK 1 „. LEEMS (1) CUE 7 < > 
end if 
MESE 
EMG SUS 
MISE OE 


SEM 

<body 

<form runat="server"> 

<asp:CheckKBoxXList 1d="checkl" AutoPostBack="True" 
TextAlign="Right" OnSelectedIndexChanged="Check" 
runat="server"> 


نتيجة تنفيذ هذا المتال ستكون على الشكل 


GASB NSE KECE ECM OV ASO ISE ECM 
aS: LA SE Ecem EEeM Z2VaASBE AS EI ECEM, 
ASB NSE NEEM ECM SASL SE ECM 
ASB NS EN ECEME ECM A ASO SEI ECEME 
ASO A SENE eM ME eM SCA SO E SE ECM 
<aSP:Listltem>Item 6</asp:ListItem> 
</asp:CheckBoxList> 
E 
<asp:label id="mess" runat="server" /> 
< / OEMS 
€ / OOS 
</html> 

FW Item 1 

T7 ltem 2 

¥ Item 3 

¥ (tem 4ã 

FW Item 5 

IT’ Item 6 

Selected Itemis): 


arm 1 
tem 3 
tem 4 
tem 5 


مثال 


في المثال التالي استخدمنا عنصر تحكم iمgذج‏ وڊ DropDownList‏ . 
سيقوم هذا البرنامج عند النقر على زر انطان؟ بإظهار رسالة تحتوي على العنصر المختار. 
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<script runat="server"> 
Sub submit (sender As Object, e As EventArgs) 
mess. Text="You selected " & dropl1l.SelectedItem. Text 
Cl SUS 
C/ SOE LOS 


SEMIS 
<bodyZz 


GEO EUMaANCL =H SEE VOR NS 


<asp: DropDownList id="dropl" runat="server"> 
GEESE LA SL LEO 1E CM L</AEO: LLC LECE 

ASO LA SL LEO 1EEM Z7I: LLEELEEMS 

ASD: A SIE LIE CM-I ECM 0<7 4S0: UA SE N ECEME 

ASB NSE ECEME IEC AAS LISE ECEME 

ASPENS EMEC ECM O ASO LISE ECEME 

CESS LS SE ME CMe MiECM 6<7 450: U SE ECEME 

</asp:DropDownList> 

ASD BUEEON TOX t=HOMOMLEY OACLILEK=N SUOMLEY EUNAE=NSOCVEEN f> 


OASIS LASSEN 1ME SSN EUNIE=WN SEC VEC ASSO 
€ / OEMS 


€ / OOS 
€ JME YS 


ستكون نتيجة تنفيذ هذا المثال على الشكل: 
Submit |‏ 


Tol selected lem 3ã 


مثال 
نستخدم في المثال التالي عنصر تحكم iمgذج‏ وب DropDownList‏ . 
سيقوم هذا البرنامج عند النقر على زر انططان؟ بإظهار رسالة تحتوي على العنصر المختار. 


<SCELOIL  EUNAE=YN SEC VEO WS 

Sub Page_lLoad(sender As Object, e As EventArgs) 
1f check1.Checked then 

panell1.Visible=false 
El5ê 

panêll1.Visible=true 

end if 

EHn@ SUb 

CJOCELOLS 
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SRE 
<Booyz 


<form runat="server"> 

<asp:Panel id="panel1" 
EWE = "SEK VEE BACK COLOE= HE E OOOO 
MOLE E=Y 1O WLC =F 1 OVS 
ASP.NET 

</asp:Panel> 

<@4S5:ChEcKBox i1d="check1™ 

Ex WHI Banal COM KOL 

E UMA 1 SEVE ES 

IE SOE > 

ASO? BULEOA Text = RelOadY runat=NeerverY /> 


€ / EOE 
</body> 
€ /MEMLS 
ستكون نتيجة تنفيذ هذا المتال على الشكل:‎ 
THide Fanal control W Hide Fanal control 
Reload | Reload | 
مثال‎ 
: tableCe11,tab1e Row «table نستخدم في المتال التالي عنصر تحكم iموذج وب‎ 
SRE 
<BOoOy z= 


IE OEM 1 UNE E= SOE VEKE > 

ESD E TENSLê EUNAL=NSEFWOEEY CELLPaAClALNEO= SY 

GridLines="horizontal" HorizontalAlign="Center"> 
<aspPp:TableRow> 
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CEES TSLECSLLS 2/A: TADLECELLS 
</asp:TableRow> 
<aspPp:TableRow> 
CACO E LADLECOLLS ISAS: LAOSLEOCELLS 
CAE TENOLECOLL SAAS TAOLECELLS 
</asp:TableRow> 
</asp:Table> 
o f> 
<asp:Table runat="server" CellPadding="5" 
GridLines="vertical" HorizontalAlign="Center"> 
<aSspPp:TableRow> 
€ ASD: TNSLECELLSL< ASS: LIAOLECELLS 
€ ASO E LNOLECELL SAAS TAOLECELLS 
</asp:TableRow> 
<aspPp:TableRow> 
CASO: TANOLECELLS I< ASO TAOLECELL > 
CEES: LElOLECeOL LL 4<7 SES: lalo lECEL LS 
</asp:TableRow> 
€ / ASO: LEONE 


TOI 
</body> 
€ MEALS 
ستكون نتيجة تتفيذ هذا المثال على الشكل:‎ 
12 
SE 
مثال‎ 
"۲ ٠×)80× يوضح هذا المتال الخصائص المختلفة لعنصر تحكم النموذج من نوع‎ 
DEMS 
Boyz 


<form runat="server"> 

A basic TextBox: 

ASO? TEXEBOS AEE ECUNAL= SERTE #3 

GIO /S<OE 3 

A password TextBox: 

ASD LOEBOS LEHEO2 Tex CMOoOdEe=HIASSWOCAS CUMA EOE VEY > 
OE JOE 73 

A TextBox with text: 

A@$ TEXEBOxX id= TEeExt=NHEelLLO WOoOELALYT CUnat=" server /> 
OE JOE 3 
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<A: TOXEBOS LEHEOAS TextMode= mult ALAReEY ECUNAC=N Server /= 
OE JOE J> 

A MEX EBOXS MIEN Me OME: 

<asp: TextBox id="tb5" rows="5" TextMode="multiline" runat="server" 
3 

OE /SOE [3 

A TextBox with width: 

A9 LOxXEBOS LAHEY COLUMNS IOY FURNACE =" SOEFYVEEY 7> 

€ j OKI 

</body> 

TRE 


ستكون نتيجة تنفيذ هذا المتال على الشكل: 


A basic TeڳtEox:‎ | 
A password TexlBoyc fmm 
A TextBox with text: [Hello world! 


ا 


A, TextBox with hel ght: 


A, TextBox with wi ath: | 


الفصل السادس 


عنوان الموضوع: 
عناصر تحكم التحقق من الإدخال. 


الكلمات المفتاحية: 


عنصر تحكم » جهة المخدم » وب » تأشيرة» خصائص » طرائق» أحداث 
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ملخض : 

تشكل عملية التحقق من الإدخال جزء أساسي في أي تطبيق على الوب. 

سنستعرض في هذه الجلسة مجموعة أخرى من عناصر التحكم من جهة المخدم نطلق عليها اسم عناصر تحكم التحقق من صحة 
الإدخال 


أهداف تعليمية: 

يتعرف الطالب في هذا الفصل على: 

٠‏ عناصر تحكم التحقق من إدخال من جهة المخدم 
٠‏ تفاصيل وأمثلة متنوعة حول عناصر تلك العناصر 


عناصر تحكم السؤولة عن اعتمادية الدخل 


Input Validation Control 


لطالما كانت متطلبات التحقق من اعتمادية الدخل من أكثر المهام صعوبة في بناء نماذج وب تفاعلية. إذ يمكن 
لهذه العملية أن تتم على مستوى المخدم أو على مستوى الزبون» ولكننا غالبأًء ولغرض التوافقية مع عدة أنواع 
من المتصفحات نقوم بهذه العملية من طرف المخدم أو نحاول استخدام لغة اما»8Sة‏ ۷هل من جهة الزبون 
كونها أكثر توافقية مع أنواع المتصفحات المختلفة. 


تقدم ۸A5P.N8E۲‏ مجموعة من عناصر تحکم ٢٥iاھidاa‏ ۷ ام1 تغطي أغلب السيناريو هات المحتملة 
لعمليات التحقق» إضافة إلى تقديم عناصر تحكم قابلة للضبط يمكن استخدامها لإنشاء عناصر تحكم ألامم1 
110ل غير قياسية. 


فيما بلي قائمة بعناصر التحكم )10٥١‏ لاھ ۷ امہ[ مع توصیف کل منھا: 


يقوم بالتحقق من أن العنصر الذي يتم التأكد 


<asp:requiredField V alidator> 
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يمكن استخدام هذا العنصر بالتعاون مع 
أخر ی put a11 a10‏ 1nعناصر‏ 
لمعالجة العناصر الفارغة. 

يقوم بالتأكد من أن القيمة في العنصر الذي 
يتم التأكد منه» تقع ضمن المجال المحدد 
سواء كان هذا المجال يشمل مجموعة من 
المحارف أو الأرقام. 

يقوم بالتحقق من أن القيمة التي يتم التأكد 

منها لعنصر التحكم مطابقة لقيمة عنصر 
تحكم آخر أو لقيمة محددة . 

SSIs me ml 

خالي» لا تتم عملية التأكد. 


<asp:RangeV alidator> 


<asp:CompareV alidator> 


يقوم بالتأكد من أن عنصر التحكم الذي يتم 
التأكد م فطاع اتر اسي <asp:RegularExpression Validator‏ 


> 
إذا كان عنصر التحكم الذي يتم تقييمه 


خالي» لا تتم عملية التأكد. 

تأكد مُعرّفة من قبل المستخدم عبر تابع 
تحقق معين من طرف المخدم أو الزبون أو <asp:CustomV alidator>‏ 
کلاهما. 

إذا كان عنصر التحكم الذي يتم تقييمه 
خالي» لا تتم عملية التأكد. 

يقوم بإظهار تقرير بأخطاء عملية التأكد <asp: ValidationSummary>‏ 
الجارية. 


عناصر تحكم السؤولة عن اعتمادية الدخل 
Input Validation Control‏ 


لطالما كانت متطلبات التحقق من اعتمادية الدخل من أكثر المهام صعوبة في بناء نماذج وب تفاعلية. إذ يمكن 
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لهذه العملية أن تتم على مستوى المخدم أو على مستوى الزبون» ولكننا غالباء ولغرض التوافقية مع عدة أنواع 
من المتصفحات نقوم بهذه العملية من طرف المخدم أو نحاول استخدام لغة امذه؟ه ۷ه[ من جهة الزبون 
كونها أكثر توافقية مع أنواع المتصفحات المختلفة. 


تقدم ۸A5SP.NE۲‏ مجموعة من عناصر تحکم ٥٥1اھ‏ اھ۷ utمم1‏ تغطي أغلب السيناريو هات المحتملة 
لعمليات التحقق» إضافة إلى تقديم عناصر تحكم قابلة للضبط يمكن استخدامها لإنشاء عناصر تحكم ألامم1 
۷110 غير قياسية. 


ما الذي تستطيع أن تفعله عناصر تحكم 
Input Validation‏ 


يجري ربط عنصر تحكم ١0ا3‏ 0ا۷۵ ابام"| أو أكثرء مع أحد عناصر تحكم الإدخال التي نود التأكد منها: 

٠‏ عند إرسال الصفحة من قبل المستخدم قوم کل عنصر تحکم ۸٥iھهiاج۷‏ utمہا‏ بالتأكد من القيمة 
الموجودة في عنصر التحكم المرتبط به ليرى فيما إذا كان سيتجاوز اختبار التحقق. 

٠‏ في حال أي فشل في اختبار التحقق يقوم عنصر تحكم 21¥ ^81^ 0 اجه iاج۷‏ بإظهار رسالة الخطاً 
أن خب ا الاا: 

٠‏ تقوم عناصر تحكم ١0اه‏ ااج۷ أuمما‏ باكتشاف نوع المتصفح المستخدم وتوليد نص برمجي من 
جهة الزبون في الصفحة لإتمام عملية التحقق. 

٠‏ يستخدم النص البرمجي من جهة الزبون لغة ا0111 لإظهار محتوى عنصر التحكم على الصفحة 


يقدم هذا الحل واجهة ذات استجابة عالية مشابهة بشكل كبير لما يمكن فعله باستخدام النصوص البرمجية 
المطورة يدوياً . 


تؤمن عناصر تحكم ألام"| ءاه٣٤مه‏ أيضاً الحماية من الاستخدام السيء لصفحات الموقع. فعملية التحقة 
من الدخل من طرف الزبون جيدة ولكنها غير آمنةء إذ يمكن للأشخاص الذين يرغبون في اساءة استخدام 
الموقع» إنشاء صفحاتهم الخاصة أو التعديل على الصفحات التي تصلهم بحيث لا يتم التحقق من المدخلات 
ويمكنهم بذلك ان ينتحلوا هوية مخدمك بإرسال معلومات غير صالحة. 


على أي حال وبالرغم من كون عناصر تحكم 0۸ا4 0ا۷2 تقوم بالتحقق من الدخل من طرف الزبونء إلا 
نها تقوم بنفس الفحص على المخدم عند إرسال الصفحةء وبهذا نستطيع الحصول على سرعة تجاوب في حالة 
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النصوص من جهة الزبون» وعلى الأمان في حالة النصوص البرمجية من جهة المخدم. 
يمكننا إلغاء عملية التحقق من صلاحية الدخل من جهة الزبون في حال عدم الحاجة إليهاء إضافة إلى إمكانية 


التق من صااة اناف الفخل يضور تفضا وريد رسال خط مخصكة فوضا عن اك ان صر 
llتحكp .ValidationSummary‏ 


BaseValidatO0r »ص‎ 


٠ه‏ ترث جميع عناصر تحكم ١0|أ2هااة۷‏ خصائص وطرائق وأحداث الصف القاعدي 
.BaseValidator‏ 


٠‏ بيعتبر الصف 210۲ل iاج6۷ء8Ba‏ جزءً من فضاء الأسماء 
System.Web.UI.WebControls‏ 


٠‏ يقدم الصف 210١‏ iاجة0۷ءه8‏ مجموعة من الخصائص والطرائق المشتركة مع جميع عناصر تحكم 
.Validation‏ 


٠‏ أهم تلك الخصائص والطرائق: 


الأحداث الخصائص عنصر التحكم 
ا RequiredFieldValid‏ 
1F InitialValue‏ 
RangeValidator MaximumValue, OnServerValid‏ 
MinimumValue, Type ate‏ 
DisplayMode,‏ 
ShowHeaderText,‏ و 
validationSummary ShowMessageBox -‏ 
ShowSummary‏ 


٠ه‏ ترث جميع عناصر تحكم ١0|أ2هااج۷‏ خصائص وطرائق وأحداث الصف القاعدي 
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.BaseValidator 


ه٠‏ بيعتبر الصف 0۲ا2 iاج‏ 6۷ء82 جزءأً من فضاء الأسماء 
System.Web.UI.WebControls‏ 


يقدم الصف 20١‏ ااج۷٥ءه8‏ مجموعة من الخصائص والطرائق المشتركة مع جميع عناصر تحكم 
.Validation‏ 


RequieredField Validator £ gi عنصر التحكم من‎ 


: مثال‎ 
A Required Value: 
CLA EoOO=NEOREN LOU ERECULEEMY Size 20Y EUNAC=NSerTVEEY /> 
<A SOS REGUL EOCELELEVALICIAEOS tE=WvaA le GULEeEGMY UMA — W SEE El 
COREE OLTOVANL CENE HE XE ECU L1 EY 
ErrorMessage="* You must enter ã value in the first textbox" 


DSO COM aAMIELS 
* 


</asp:RequiredFieldValidator> 


نلاحظ بأننا قمنا بتحديد عنصر التحكم ۵4١۲ءا‏ 8]×) ليتم التحقق منه بواسطة عنصر التحكم 
RequieredFieldV alidator‏ وذ بiwlاد‏ llقيnة txtRequiered‏ إلى llخëزاصةÃ .Control To Validate‏ 


قمنا أيضاً بتحدبد رسالة الخطاً التي ستتم إعادتها إلى المستخدم من خلال الخاصة eعErrorMessa.‏ 
تحدد الخاصة لهام فيما إذا كان عنصر التحكم سيحتل مكان في الصفحة حتى لو لم يتم إظهاره. 
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CompareValidator مpك<تl عنص‎ 


يستخدم عنصر التحكم هذا لمقارنة قيمة مدخلة مع قيمة عنصر تحكم آخر أو قيمة ثابتة. 


يعتبر المثال التالي استمرار للمثال السابق حيث نلاحظ أننا أضفنا حقل إدخال نصي جديد وقمنا باسناد القيمة 


txt compare‏ إلى الخاصة عا1daاa Contro1 10V‏ والقيمة 4عu1۲اx]Req]‏ إلى الخاصة 


Cntr 0"0 0mpare‏ حيت تحدد هاتان الخاصتان اسماء عناصر التحكم التي يراد التحقق من تطابق 


مدخلاتها. 


تحدد الخاصة إه0اهإهم0 نوع المقارنة بين قيمتي عنصري التحكم المقارنين ويمكن أن تأخذ إحدى القيم: 


( Equal,greaterThan,LessThanOrEqual,..) 


The Same Value Again: 


EVOE=WEEXEN AEC WEECOMIAEEN Size Z2O0Y EUMEAE=WEC VEEN £> 


<a :COMPaAEFEValidator 1d="valComparê" rüunalt="server" 
ControlToValidate="txtCompare"™ 

ControlToCompare="txtRequired" 

OPE a EOE > Mea 

ErrorMessage="* You must enter same value in the second textbox" 
Display="dynamic"> 


</asp:CompareValidator> 


<input 


x 


كما يمكن استخدام عنصر التحكم ٣0اه‏ ل اة ۷١۵۲م‏ إ٥‏ لمقارنة دخل عنصر تحكم مع قيمة ثابتة كما في 


المثال التالي: 


dr LEE ZE JUL ZOOS 
EVOS= EEOC AOE ECOMOIAEeDAEE SIizZéE=I0Y EURaAt=NSEETOEEY /> 


<asp:CompareValidator id="valCompareDate" runat="server" 
ControlToValidate="txtCompareDate" 

VALUE LOCOM oA EeE= 27/6/20058 

Operator="GreaterThan" 


Date" 


ErrorMessage="* The Date must be later than 27rd July 2005" 
DES OLE COMA E LS 
* 


4 0e 
LOUIE 


Type="] 
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| </asp:CompareVvalidator> 


نلاحظ هنا أننا استخدمنا عنصر التحكم ١0هل‏ ناة۷ءإaممره٤‏ لمقارنة القيمة المدخلة في العنصر 
txt 0m pareDate‏ مع القيمة الثابتة "27/6/2005'. نلاحظ أننا لم نجر المقارنة اعتماداً على النمط التلقائي 
وهو ٣۲1ا‏ بل حددنا نمط البيانات على أنه تاريخ باستخدام التعبیر ”ع ”=عمر٣ا.‏ 


تكون الأنماط المتاحة للبیانات هي .Currency,Double,Date,Integer,Sriıg‏ 


:Compare Validator pSaتll‎ رصiع‎ 

يستخدم عنصر التحكم هذا لمقارنة قيمة مدخلة مع قيمة عنصر تحكم آخر أو قيمة ثابتة. 

يعتبر المثال التالي استمرار للمثال السابق حيث نلاحظ أننا أضفنا حقل إدخال نصي جديد وقمنا باسناد القيمة 
txt compare‏ إلى الخاصة عا1daاa Contro1 10V‏ والقيمة 4ع1۲اx]Req]‏ إلى الخاصة 

Cntr 0"0 0mpare‏ حيت تحدد هاتان الخاصتان اسماء عناصر التحكم التي يراد التحقق من تطابق 


مدخلاتها. 


تحدد الخاصة ١إ0اة۲إ٠م0‏ نوع المقارنة بين قيمتي عنصري التحكم المقارنين ويمكن أن تأخذ إحدى القيم: 
Equal,greaterThan,LessThanOrEqual,..)‏ ( 


كما يمكن استخدام عنصر التحكم 0۲هل 1اه ۷ء٣2مmهع‏ لمقارنة دخل عنصر تحكم مع قيمة ثابتة. 


عنص llتھكم Range Validator‏ 
يستخدم عنصر التحكم هذا لتحديد المجال المسموح للقيم التي يمكن أن يأخذها عنصر تحكم ما. 


لا بد في حالة عنصر التحقق هذاء من تحديد ثلاث خصائص أساسية: تتعلق الأولى بنمط البيانات المستخدمةء 
أما الثانية والثالثة فتحدد القيم العليا والدنيا المسموح إدخالها من النمط المحدد. 


تستخدم الخاصة الأولى التعبير ءمر1 وتستخدم الخاصة الثانية التعبير 21u‏ 0۷ 14×10۷ء وتستخدم 
الخاصة اlilلثة .Minimum Value‏ 
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ففي النص البرمجي التالي نلاحظ أننا نقوم بإسناد القيمة إ#ععا.! للخاصة عمرآ واسناد القيم 1 و 10 


MinimumValue و‎ Maximum Value jيتصاخأنل‎ 


A Number between 1 and 10: 

GILROLE EVOE=NEEXEN LOWE ERANEGEN SIZI CUNAE Wee VEEN {3 
<A SOE RAMEE VAL LCAEAEOE LE MAL Sene eê # EUMENE = SEE Ol 
ControlToOoValidate="txtRange" 

MaximumValue="10" 

MinimumValue="1" 

Type="Integer”" 

ErrorMessage="* The Number must between 1 and 10" 
Display="dynamic"> 

Xx 


</asp:RangeValidator> 


يستخدم عنصر التحكم هذا لتحديد المجال المسموح للقيم التي يمكن أن يأخذها عنصر تحكم ما. 


لا بد في حالة عنصر التحقق هذاء من تحديد ثلاث خصائص أساسية: تتعلق الأولى بنمط البيانات المستخدمةء 
أما الثانية والثالثة فتحدد القيم العليا والدنيا المسموح إدخالها من النمط المحدد. 


. Minimum Value ةثلlill الخاصة‎ 


عنصر تحكم التحقق باستخدام التعابير النظامية 


تعرف التعابير النظامية بأنها عبارة عن مجموعة من الرموز والإشارات التي تستخدم لتحديد تنسيق معين 


للبيانات. من أشهر هذه الرموز : 


تمتلك ۸5۲.٤1‏ عنصر تحكم ١٥1اة‏ :اه۷ خاص بالتعابير النظامية يقوم بالتأكد من مطابقة قيمة ما 
مدخلة مع تعبير نظامي محدد. يتم تحديد صيغة التعبير النظامي ضمن الخاصة .ValidationExpressi0¬‏ 


سنستخدم في المثال التالي عنصر التحكم الخاص بالتعابير النظامية للتأكد من أن التعبير المدخل ضمن عنصر 
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تحكم النص ۲م×٤ع٥۸)×]‏ هو تعبير عنوان بريد إلكتروني صحيح. 
نلاحظ أننا استخدمنا التعبير النظامي *..ا*.@*. للخاصة ٣s101وء!م8x dation‏ iاa‏ ۷ حيث يعبر رمز . 


عن أي محرف و * عن تكرار لاآي محرف 


Malle SEE SS O LS O OLE 

GLMOUE EYOE=HEESEY LENE XEROEGESOE™ EAiz20=NA40Y euUnat =" Server /> 
<asp:RegularExpressionValidator id="valRegExpr" runat="server" 
COREE OLTOVALLEAEE= NE XC REG EOE 

VALICAELONEPEOSSLORSEN FE. Foo 

ErrorMessage="* Your entry does not match the regular expression" 
DSO COM aAmMIE LS 

Xx 


</asp:RegularExpressionValidator> 


تعرّف التعابير النظامية بأنها عبارة عن مجموعة من الرموز والإشارات التي تستخدم لتحديد تنسيق معين 
للبيانات. 


تمتلك ۸5۲.٤1‏ عنصر تحكم ١٥11هل‏ اه۷ خاص بالتعابير النظامية يقوم بالتأكد من مطابقة قيمة ما 
مدخلة مع تعبير نظامي محدد. يتم تحديد صيغة التعبير النظامي ضمن الخاصة .ValidationExpressi0¬‏ 


عندما تكون عملية التحقق التي نود إجراءها أعقد من أن يلبيها أي عنصر من عناصر التحكم التي 
استعرضناها مسبقاً » نستطيع استخدام عنصر تحكم التحقق المخصص .Cust0 ٥1۷ a1140‏ 


نستخدم في المثال التالي عنصر التحكم إ0اةل1اة۷ءإهم هه للتأكد من إدخال قيمة أكبر من 100 وعنصر 
التحكم إ0ا لا ۷ Custom‏ لفحص القيمة وتقييمها: 


A Prime Number over 100: 

GIROUE EVOE=NEEOSEN AONE ECUSEOMNY SIZI CUMAE=NSE VEY > 
<A4S55:CoOoMGpareValidator iû="valComparePrime" runat="server" 
CONEEOLTOVaALIIALCE=TTSTECUSEOMT 

ValueToCompare="100" 

Operator="GreaterThan" 
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Typé="Intêegêr" 

ErrorMessage="* The Prime Number must be greater than 100" 
Display="dynamic"> 

%8 


</asp:CompareValidator> 

EAS OE CUS E OVAL LEE OE LEMA LCUSE OMY EUNICE = HECÊ vê 

COR EEO LEO Va U Ea e— EEC US EON 
ClilentEValidalionFUnNCELonS"CllentValidate" 
OnServerValidate="ServerValidate" 

ErrorMessage="* Your knowledge of prime numbers is not optimal" 
Display="dynamic"> 

% 


C/A: CUS TE OMVALLAEILOCZ 


يعتمد عنصر تحكم OnserverValidate ş ClientValidationFuncti10¬ „aصاlخ CustomV alidator‏ 
لتحديد اسماء التوابع المخصصة التي سنقوم بإنشائها للتحقق من القيمة. 


عندما تكون عملية التحقق التي نود إجراءها أعقد من أن يلبيها أي عنصر من عناصر التحكم التي 
استعرضناها مسبقاً » نستطيع استخدام عنصر تحكم التحقق المخصص .Cust0 ٥۸۷ 11410١‏ 


يعتمد عنصر تكم OnserverValidate ş ClientValidationFunct10¬ يJaتصاlخ CustomV alidator‏ 
لتحديد اسماء التوابع المخصصة التي سنقوم بإنشائها للتحقق من القيمة. 


نستخدم عادة اص1اء5ه۷ه[ ذفي كتابة النص البرمجي للتابع من جهة الزبون لضمان أعلى توافقية مع أنواع 
المتصفحات وذلك لضرورة إدراج هذا النص البرمجي ضمن الصفحة. 


COREE O LIOVa LIGA ê — ESE € USE OM 

ValueToCompare="100" 

Operator="GreaterThan" 

Typé=" Integer" 

ErrorMessage="* The Prime Number must be greater than 100" 


Display="dynamic"> 
*K 


</asp:CompareValidator> 

AS OE CUS E OVAL LCE OE LEA LCUSE OMY EUNEE= HECE wO 
COREEOLTOVALIEaAEE= HE x< CUS OMY 
ClilentValidalionFUnNnCEIoONS"CIlILEeENnEValidate" 
OnServerValidate="ServerValidate" 

ErrorMessage="* Your knowledge of prime numbers is not optimal" 
Display="dynamic"> 
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x 


</AS08 CUSEOMVALLAALOES 

<SGELBE lanGuUage="JavaSCEIpET> 
دا‎ 
// CLIENL=S1CS VALICACLON EUACLLOS EOC CUSE OVAL LOAEOKE 
UME LOM CALLER VAL LCA E (OO SOUECE, OOJAEGS) 

wee OlMMal Ad = EEUU, 


var intNumber = objArgs.Value; 

LE (ILMEN © 2 == ly) 

wel MEDIA WLSOE — MELE ¢ E LOOL (UAC NUNS / YF 
LE (AMEDLIVLSOE > 2) 

EOE (welê 1 = SS U = MONEDA SOE 1 = A ك‎ U 
LE (AMER 4 AMEDI W1 SOE —— O) 

LAVALLE = FAL Sê f 

break; 


} 

} 

else 

OLMMEL LE = FEALSCS 
} 
e 
5 


InValid = false; 
SBJAE OS ISVaAlLTS = OIMVaALTGA;, 


//--< 


MSE NOE 


نلاحظ كيف توفر عناصر تحكم التحقق مرجع إلى نفسها هو eءء50u۲[ط0»‏ بالإضافة إلى غرض بإسم 
6 يتضمن عناصر هذا التابع. 


نحصل على قيمة عنصر التحكم من خلال الحقل عuاة۷‏ ل ءعإء4[طا0 ونسند قيمة إلى الحقل ا۷ء 
الخاص ب ءعإ 4زط0 لتحديد فيما إذا نجح التحقق أم لا. 


أما فيما يخص التحقق من طرف المخدم › نستخدم نفس المبداً وهنا يجب علینا استخدام ۷8.۴1 لإنشاء 
التابع من جهة المخدم. 


في هذه الحالة يقوم التابع على المخدم باستلام مؤشر إلى عنصر التحكم والغرض 
ئشٍlidateEventArاerverVa‏ الحاوي على قيمة عنصر التحكم كقيمة للخاصة عuاج۷:‏ 


OLAWALLEO = FAL, 
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} 

else 

bInNValid = false; 

OO JA CE . LSVEALLC = OLMMENL EO 

ie E E, 

} 

u 

€/SCELOLEZS 

Sub ServerValidate(objSource As Object, objArgs As 
ServerValidateEventArgs) 

Dim blnValid As Boolean = True 

E 
Dim intNumber As Integer = objArgs.Value 
'check that it's an odd number 

TE intNumber Mod 2 = 1 Then 

'get the largest possible divisor 

DIM LACDLWLSOS AS INEEOSE = LACNUMOSE N 3 
li AMEDI SOE > 2 TOE 

Dim intlLoop As Integer 


'Gheck USing each CivIiSor In tun 
ROE AME LOOO = 3 TO OLN WI SOE SEES Z2 
E MEN EMOEE MOG mE DAN SOE — O Mem 
blinValid = False 

BSE EON 

ENON Lac 

Next 

Else 

bInValid = False 

IMCL LIE 

Else 

OLAVaALAG = FALSE 

Ol JIE 


Catch ONJEEIOE AS Except i1 On 
blnValid =False 

BIRAY 

OBIAECGS.ISVaALIS = BlnValig 
End TIYy 

End Sub 


نستخدم عادة ام1إء5ه ۷ه[ ذفي كتابة النص البرمجي للتابع من جهة الزبون لضمان أعلى توافقية مع أنواع 
المتصفحات وذلك لضرورة إدراج هذا النص البرمجي ضمن الصفحة. 


عنص :ValidationSum mary pî‏ 
يقوم هذا العنصر بإظهار قائمة بالأخطاء عند إرسال الصفحة. 
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سنقوم في المثال التالي بتوضيح كيفية عمل عنصر التحكم هذا. 
قمنا في البداية يتحديد ترويسة ملخص الأخطاء الذي سوف يظهره عنصر التحكم وذلك باسناد قيمة للخاصة 
Header ext‏ ثم قمنا بإسناد القيمة ۲۲٥‏ إلى الخاصة S۸0۷80۳2‏ بحيث يتم إظهار قيمة 
الخاصة ۴۲۲١۲١1٥55498‏ المرتبطة بكل عنصر تحكم (يجري التحقق منه) في حال فشل الاختبار على هذا 
الاضمر. 

ASD: Val TGA E1 OR SUMMA Y 1A val SUMMA Yl KUNA SOE EE 


HeaderText="<bþb>The following errors were found:</b>" 
ShowSummary="True" DisplayMode="List" /> 


تمكن الخاصة 0٥N0۵/هامءا0‏ من اختيار طريقة إظهار رسائل الخطأبحيث يمكن أن نسند إلى هذه 
الخاصة القيم .List,BulletList, Single Paragrap)‏ مكنذا أيضا استخدام الخاصة ۴0۲۳0۱0۲ لضبط 
لون ار اة : 

تعثبر الخاصة 5۸0W165529680×‏ أحد الخصائص المفيدة أيضاً إذ تحدد هذه الخاصة إظهار ملخص 
نتائج الخطاً ضمن علبة حوار عوضا عن الصفحة نفسها. 


Microsoft Internet Explorer ET × 


The Following errors were Found: 

* Yol mist enter ã Yalue in the First text box 

* Yol must enter the same Yalue in the second text box 
* The Date must be later than 3rd March 2001 

* The Number must between 1 and 10 

* Your entry does not match the regular expression 

* The Prime Number must be greater than 100 

* Your knowledge of prime numbers is less than opkirnal 


يقوم هذا العنصر بإظهار قائمة بالأخطاء عند إرسال الصفحة. 


تعطيل وتفعيل النص البرمجي من جهة الزبون أو المخدم وlلخاصةA EnableClientScript‏ 
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يمكن تعطيل أي نص البرمجي خاص بعناصر تحكم» على المخدم أو الزيونء بتعديل قيمة الخاصة ٥1ا۴2‏ 
ڪ EnabledClientScript‏ 


Sub Page_Load() 

Dim objValidator As BaseVvalidator 

HO Hae COLA LTE IM Eade VA URS AEOES 

objValidator.Enabled = 1stEnabled.SelectedItem. Text 
objValidator.EnableClientScript = 1stClientScript.SelectedItem. Text 
NESSIE 

ENG Sub 


الفصل السابع والثامن 


راق الموشوع: 


الكلمات المفتاحية: 


عنصر تحکم»› قيمة»› قائمة» صف» عمود» متكررة» وحيدة» غرض»› حقل»› ربط بیانات»› نص بر مجی»› خاصة» قاعدة بيانات. 


ملخضص : 
کک ق ف ی ا ا ا 


أهداف تعليمية: 

يتعرف الطالب في هذا الفصل على: 

٠‏ مبداً ربط البيانات 

٠‏ كيف نستطيع ربط عناصر تحكم إلى قيمة وحيدة 

٠ه‏ كيف يمكننا ربط عناصر التحكم إلى مجموعة من القيم 
٠‏ كيف نغير مظهر طريقة إظهار عناصر التحكم المرتبطة 
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عناصر تحكم القوائم والربط مع مصادر البيانات 


تحتاج أغلب مواقع وتطبيقات الوب إلى الوصول إلى مصادر البيانات في مرحلة ما. وقد استطاعت ۸8۶۲ 
تأمين هذا الاتصال مع العديد من أنواع مصادر البيانات مثل قواعد البيانات العلائقية» ومخدمات البريد 
الالكتروني» ووثائق ۷1× والملفات النصيةء كما استطاعت تأمين العمليات عليها وتنسيقها وإظهارها بعدة 
طرق. ولكن العمل مع ۸5۶ كان يتطلب كتابة نصوص برمجية لتأدية هذه الأعمال مما يجعلها تستهلك الوقت 
وتسبب مصاعب في الإدارة وفي إزالة العلل. 


قدمت ۸8۴.81 طرق جديدة لإدارة وإظهار البيانات من كل الأنواع. إذ تجري إدارة البيانات في 

SP. N1‏ عبر مجموعة متكاملة من عناصر التحكم من جهة المخدم التي تم تصميمها للعمل مع جميع 
أنواع قواعد البيانات وليس مع البيانات العلائقية ولا مع وثائق ۷1× فقط. 

الجديد هنا أننا لسنا مضطرون لمعرفة مصدر البيانات بشكل كامل» ولا معرفة كيفية استخراجها حتى نستطيع 
استخدام عناصر التحكم الخاصة بالبيانات. ۰ 

التصميم غير المتصل وغير الآني (٥«1ل‏ ؟0۴) المعتمد في إطار عمل ..٤1‏ يعني أنه يمكن لنا فصل 
قواعد العمل التي تقوم بالتعامل مع البيانات عن تلك التي تتعامل مع إظهارها. 
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لذا سنتعرف في هذه الجلسة على: 


# مبدأً ربط البيانات؛ 

# كيف نستطيع ربط عناصر تحكم إلى قيمة وحيدة 

# كيف يمكننا ربط عناصر التحكم إلى مجموعة من القيم 

#كيف نغير مظهر طريقة إظهار عناصر التحكم المرتبطة 
ربط البيانات 


يصعب تعريف مبداً ربط البيانات بصورة عامة في لغات البرمجة مثل يهط 41ء۷1 وفي التطبيقات مثل 


.Microsoft Access 


يعرف مبداً ربط البيانات بأنه الطريقة التي ترتبط فيها عناصر تحكم على نموذج» بقيم من حاويات بيانات مثل 
قيم الحقول بصورة آلية ضمن عناصر التحكم. 


ترتبط عناصر التحكم بالحقول في مجموعة السجلات ولسنا بحاجة لكتابة أي نص برمجي لإظهار القيم أو 
تحديث مصدر البيانات الأصلي. 


عموماء لاتسمح طبيعة البروتوكول 1١۲۴‏ باستخدام الطريقة التقليدية (زبون-مخدم) المستخدمة في اهائز۷ 
Basic‏ و .Access‏ لذا تضمن متصفح 184 بعض مكونات 0K0۷‏ من طرف الزبون والتي سمحت 
باستخدام تقنيات مماظة لتلك المستخدمة في ۷8 و ءیع>ءء۸ مع البروتوكول 11۲۲۶. تمت تسمية هذہ 
الكونات بمكونات ربط البيانات من جهة الزبون» ولكن العديد من الشكوك التي ظهرت والتي تعلقت بأمان 
المعلومات أدت إلى عدم الاعتماد على هذه الطريقة بشكل أساسي. 


إدارة جميع الأعمال على المخدم: 

إن التعدد والاختلاف بين التجهيزات وتطبيقات المستعرض من طرف الزبون جعل من استخدام تقنية تتعلق 
بالمتصفح أمرا غير محبب» لذا سعت مايكروسوفت في .N€‏ إلى تقديم دعم لأغلب أنواع الزبائن إما ببناء 
تطبيقات تتحسس نوع التطبيق الزبون وتغير تصرفها بشكل يتوافق معه»ء أو بوضع جميع الفعاليات على 
المخدم: 
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في الكثير من الحالات تعد عملية إذارة جميع الأعمال على المخدم خطة جيدة لأنها تسمح لتا بإنشاء عناصر 
تحكم ضمن الخرج» كما تسمح بزيادة أمان التطبيقات. 

تم الاتجاه في بيئة .N٤1‏ إلى مبداً ربط البيانات من جهة المخدم والاستفادة من ميزاته في توفير الوقت 
والتقليل من كتابة النصوص البرمجية والعمل بتقنيات مشابهة لتلك المستخدمة في ۷8 و كءعءء۸ ولكن عبر 
البروتوكول 1117۶ في بيئة غير متصلة كبيئة الوب. 


إظهار البيانات 


استطعنا في نسخة ۸8۶3.0 والنسخ السابقة لھا استخدام مکونات أو تقنيات مثل ۸50 لإنشاء غرض 
€تءعr‏ يحتوي الصفوف والبيانات التي نود إظهارها. 

وكنا نضطر -لوضعها على الصفحة- إلى الدخول في حلفة تكرارية عبر الصفوف لاستخراج القيم» وتنسيقها 
ووضعها ضمن الخرج كما يظهر في المثال التالي: 


...' assuming we've got a Recordset object containing the data ... 
Response.Write "<table>" 

Response.Write "<tr><th>Date</th>" 

Response.Write "<th>Subject</th>" 

Response.Write "<th>User Name</th>" 

Response.Write "<th>Content</th></tr>" 

Do While Not objRecs.EOF 

strDate = FormatDateTime(objRecs("dtDate").value, vbLongDate) 
Response.Write "<tr><td>" & strDate & "</td>" 

Response.Write "<td>" & objRecs("tSubject").value & "</td>" 
Response.Write "<td>" & objRecs("tUserName").value & "</td>" 
Response.Write "<td>" & objRecs("tContent").value & "</td></tr>" 
objRecs.MoveNext 

Loop 

Response.Write "</table>" 

objRecs.Close 


لأداء نفس العمل في ۸5۴.٤1‏ يكفي كتابة النص البرمجي التالي: 


<!-- the server control located in the HTML section of the page --> 
<ASP:DataGrid id="MyDataGrid" runat="server" /> 

...' assuming we've got a DataView object containing the data ... 
MyDataGrid.DataSource = objDataView 


MyDataGrid.DataBind() 
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يقوم عنصر تحكم المخدم بأداء نفس العمل الذي يقوم به النص البرمجي 3.0 ۸5۶ آليأ: إذ يقوم بإنشاء جدول 
1M‏ بأسماء الحقول في الصف الأول» متبوعاً بسلسلة من الصفوف التي تحتوي القيم الخاصة بكل صف 
قي ممصن البياناته وفطي يكل بساظة تخي تسق الجدرل بشديل خصاتض عنص ادك 
.ASP:DataGrid‏ 

فعلى سبيل المثال نستطيع إضافة ترتيب آلي أو تقسيم إلى صفحات أو إظهار رقم الصف فقط بإسناد قيم 
اين الان راف مط ا مرن إلى انض لري 


تقدم ۴1 ۸8۴.N‏ عناصر تحكم يمكن استخدامها لتأمين إظهار البيانات سواء كانت متكررة كما في مثالنا 
السابق»ء أو كانت تتعامل مع عنصر بيانات وحيد. يجري كل ذلك من خلال ربط البيانات من جهة المخدم. 


إظهار البيانات 


استطعنا في نسخة ۸8۶3.0 والنسخ السابقة لھا استخدام مکونات أو تقنيات مثل ۸50 لإنشاء غرض 
€تءا يحتوي الصفوف والبيانات التي نود إظهارها. 

وكنا نضطر -لوضعها على الصفحة- إلى الدخول في حلقة تكرارية عبر الصفوف لاستخراج القيم» وتنسيقها 
ووضعها ضمن الخرج. 


يقوم عنصر تحكم المخدم بأداء نفس العمل الذي يقوم به النص البرمجي 3.0 ۸5۴ آليا: إذ يقوم بإنشاء جدول 
ا11 بأسماء الحقول في الصف الأولء متبوعاً بسلسلة من الصفوف التي تحتوي القيم الخاصة بكل صف 
في مصدر البيانات» ونستطيع بكل بساطة تغيير تنسيق الجدول بتعديل خصائص عنصر التحكم 
t14هط:AP.‏ فعلى سبيل المثال نستطيع إضافة ترتيب آلي أو تقسيم إلى صفحات أو إظهار رقم الصف 
فقط بإسناد قيم لبعض الخصائص وإضافة سطر أو سطرين إلى النص البرمجي. 


تقدم ۴.N ۴٤1‏ ۸5 عناصر تحكم يمكن استخدامها لتأمين إظهار البيانات سواء كانت متكررة كما في مثالنا 
السابق» أو كانت تتعامل مع عنصر بيانات وحيد. يجري كل ذلك من خلال ربط البيانات من جهة المخدم. 


صيغة ربط البيانات 


يعتمد مبداً ربط البيانات من جهة المخدم على جعل ۸8۴.٤1‏ تدر ج قيمة أو عدة قيم من مصدر البيانات 


Universal Knowledge Solutions s.a.1 104 


على الصفحة أو ضمن عنصر تحكم في الصفحة. 


تستخدم الصيغة الأساسية بنية مشابهة لتلك المستخدمة في كتلة النص البرمجي من جهة المخدم باستخدام 
إشارة # كدلالة على أن الصيغة هي صيغة ربط بيانات. 


<%# name-of-data-source %> 


لا يمكننا وضع النص المراد تنفيذه ضمن هذه الكتلة مع أنها تبدو ككتلة نص برمجي من جهة المخدم» ولكنها 
ليست كذلك» ولا يمكننا سوى استخدام التعبيرات الخاصة بربط البيانات ضمن هذه الكتلة. 


نميز حالتين أساسيتين في ربط البيانات: 


الحالة الأولى: ربط بيانات قيمة وحيدة: 

تستخدم هذه الحالة عندما يكون لدينا قيمة وحيدة نود ربطها مع عنصر تحكم كحال رغبتنا بإسناد قيمة إلى 
خاصة ما من خضانض غنصر اتك فى هة الحالة تخ القيمة المزقطة لث إستاذها إلى الخاصة 
المعبرة عن القيمة التي سيظهرها عنصر التحكم (مثلا خصائص 18×۲ و 0٤‏ ۷۸1). يُعتبر هذا الأسلوب 
اسا لعناصر التحكم التي تظهر لها قيمة وحيدة ASP:HyperLink «ASP: TextBox «<INPUT> Jû‏ 


الحالة الثانية: ربط بیانات قیم متكررة: 

کے هه طرق عدا بتري مضدر قات ى أك من فعا ف مل الال مها ريط قاف ا 
مجموعة أو مجموعة صفوف مع عنصر تحكم يمكنه إظهار أكثر من قيمة. 

.ASP:CheckBoxList «ASP: ListBox «<<SELEC T> Jٽn تتضمن هذه الحالة عناصر تحكم‎ 


على كل حال تستخدم نفس التقنيات الأساسية في تطبيق أي نوع من نوعي الربط. 

ربط بيانات قيمة وحيدة 
عندما نقوم بربط عنصر تحكم إلى قيمة وحيدة مثل أحد الخصائص» أو إحدى الطرائق أو أحد التعبيرات» 
يمكننا استخدام أحد الصيغ البسيطة التالية: 


<%# property-name %> 
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<%# method-name (parameter1l, parameter2,...) %o> 


أو 


<%o# expression%> 
يمكننا أن نرى من الصيغ السابقة أن هناك عدة مصادر محتملة للقيمة التي يمكننا ربطها إلى عنصر التحكم:‎ 
قيمة الخاصة المْصرًَح عنها في الصفحة أو في عنصر تحكم أو في غرض آخر.‎ 

٠‏ اللقيمة المُعادة من طريقة والمْصرًَح عنها في الصفحة أو في عنصر تحكم أو في غرض آخر. 


© ننڊٍ 0 هت پر ١‏ ن ا 


ReadOnly Property ImageURLÛO As String 

Get 

‘read-only property for the Page 

Dim strURL As String 

'some code would be here to calculate the value 
'we just set it to a fixed value for illustration 
strURL = "myimage.gif" 

Return strURL 

End Get 

End Property 


هناك عدة مصادر محتملة للقيمة التي يمكننا ربطها إلى عنصر التحكم: 
ه قيمة الخاصة المْصرًَح عنها في الصفحة أو في عنصر تحكم أو في غرض آخر. 
للقيمة المُعادة من طريقة والمْصرًَح عنها في الصفحة أو في عنصر تحكم أو في غرض آخر. 


© ننڊٍ 0 هت ر ١‏ 5 * 


استخدام عناصر التحكم مع القيم المرتبطة 


تكمن الميزة الحقيقية في استخدام القيم المرتبطة في كون كتلة ربط البيانات قابلة للاستخدام مع عناصر تحكم 
أخرى ويمكن الحصول على قيمة أحد العناصر عن طريق عنصر تحكم آخر. 


فعلی سبیل المثال یمکن ربط عنصر تحکم 1۸8٤‏ إلى عنصر تحکم ۲٥×۲80×‏ بإسناد الخاصة ۲٤×١‏ 
لعنصر التحكم ٦×80×‏ كقيمة للخاصة 1٤×1‏ في عنصر تحکم 8٤۴L‏ 1۸. 


| GEO EUNICE = W EEO S 


ASD E LOE BOS LOS HMVIESEBOSS EURAIL = EEE 73 
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ASE MaDe GA MEA E NE MESE 1 oT IME EEO MESE CL UMA SEE 
zs 

CIMOUE EVOE=N EUEY 73 

€ OEMS 

<script language="VB" runat="server"> 

Sub Page_Load() 

DaltaBinco (j 

eel SUI) 

MSE IBE 


في كل مرة يتم فيها إرسال الصفحةء ستكون القيمة في عنصر التحكم 1,48۴1 مأخوذة من عنصر التحكم 
×0 1×18 المسمى ١×)80×‏ 1ر٣‏ و لإتمام هذا العمل» لايلزمنا سوى كتابة النص البرمجي الخاص باستدعاء 
الطريقة ل811ه)Da.‏ 


لاتنحصر هذه التقنية بإسناد قيمة الخاصة لعنصر تحكم» إذ يمكننا أيضا استخدامها لإدراج قيمة في أي عنصر 
تحكم. فعلى سبيل المثالء لإعطاء قيمة للخاصة 51٥‏ في عنصر تحكم ٥ع2٠"[:۶‏ ۸5 نستخدم الصيغة: 


CASE? IMAGE SrEe=N<E IMACEUEL S> IMEC EAN 1 C= mr OCALEY EUMaALE=W SEK WEK 


f3 


لتحديد النص ومحدد المصدر القياسي ۸1ا لعنصر تحکم 1nk)‏ امم 8P: Hy‏ یمکننا استخدام: 


<ASP:HvYPer link ext l<osf ImadeURL <6>" MaviGgaleUrl-1<sf IMmadJeURL <6>" 
TURAL" SEETECY #3 


تعمل هذه التقنية بشكل مشابه مع عناصر تحكم [۲۷M‏ وحتى مع تأشيرات H]۲١۷1‏ العادية. 


GIMOUE EVOE=NEESENY VALUE= IMAGE URL SS 73 


CIMLE E VOCE SUOMLEN VALUE=, UMACEUL S> 1> 


<a href="<%# ImageURL $%>"><%# ImageURL %></a> 


a MEER LEO 7 MVS EE COM 1MAGES CE Image URE l> 
View the file named '<%# ImageURL $%>'</a> 


استخدام عناصر التحكم مع القيم المرتبطة 


تكمن الميزة الحقيقية في استخدام القيم المرتبطة في كون كتلة ربط البيانات قابلة للاستخدام مع عناصر تحكم 
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أخرى ويمكن الحصول على قيمة أحد العناصر عن طريق عنصر تحكم آخر. 


فعلی سبیل المثال یمکن ربط عنصر تحکم 1۸8٤‏ إلى عنصر تحکم ۲٥×۲80×‏ بإسناد الخاصة ۲٤×١‏ 
لعنصر التحكم ٦×80×‏ كقيمة للخاصة 1٤×1‏ في عنصر تحکم 8۴٤L‏ ۸. 


لاتنحصر هذه التقنية بإسناد قيمة الخاصة لعنصر تحكم» إذ يمكننا أيضا استخدامها لإدراج قيمة في أي عنصر 


تحکم. 
تفعيل الربط 


بعد تحديد كتلة ربط البيانات في الصفحةء يتوجب علينا تفعيل الربط وذلك عند انطلاق حدث ما (غالباً مايكون 
حدث تحميل الصفحة) لإدراج القيم المناسبة. 

إذ يجري إهمال كتلة الربط من قبل محرك ۸5۴ أثناء ترجمة الصفحة» إذا لم يجري التفعيل» ولا يجري 
عندها استبدال كتل الربط بالقيم المطلوبة. 


تجري عملية تفعيل الربط باستخدام طريقة 041481١١‏ المتوفرة في أكثر من سوية ضمن هرمية الصفحة. 
- لربط جميع عناصر التحكم ضمن الصفحة نستخدم الطريقة 04481۸١‏ الخاصة بالغرض موه۴. 
هي الطريقة الوحيدة الفعالة في حال استخدام كتلة الربط مع عناصر غير مصممة لربط البيانات (مثل 
تأشيرات ا 1۲). 


- لربط عنصر تحكم وحيد فقط نستخدم الطريقة 02481١١‏ لهذا العنصر فقط وتستخدم فقط في عناصر 
التحكم المصممة خصيصا للتعامل مع ربط البيانات. 


الغرض. وهذه الطريقة كسابقتها لا تطبق إلا على العناصر المخصصة للتعامل مع ربط البيانات. 


مثال: 
يوضح المثال كيفية استخدام ربط البيانات لقيمة وحيدة باستخدام عدة أنواع من عناصر التحكم. 
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Simple Single-Value Data Binding 


< ASP:Label> control: rryirmage. gif HTML <span> olamant: myimaga.gif 


< AGP:Textou> central: mymaqa.qf HTL input type ="teul"> aleman: Frymage gif 
< ASP:Button> control: ET | HTL input type="submit" alment: _ TYME GÎ | 


2 ASP:LinkButtan> control: myimage. gif HTL <buttonz slament: _ T24 O | 
<ASP:Image > control: 24 HTML <img> element: 20 
<ASP:CheckBox> control: T myimage.gif HTL <input type ="checkbox"> element: CT myimaga.gIf 


2 AGP:RadîaButtan= contral: TF myimame. gif HTML <mput type ="radlo"> elamêant: C myimaga.gif 


< ASP:Hyperink > corirol: myimage, gif HTML &a> abmêrt: mıyiîmiağa.gif 
TASP:ImageButton> control: € HTL button> and <img> elemane: __ | € 


@%>Page Language="VB<%" 


!>DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN<" 
>html><head< 

>title>Simple Single- Value Data Binding</title< 

>style type="text/css<" 

body, td {font-family:Tahoma,Arial,sans-serif; font-size: 10pt 

input {font-family:Tahoma, Arial,sans-serif; font-size:9pt{ 

.heading {font-family:Tahoma,Arial,sans-serif; font-size:14pt; font-weight:bold { 
.subhead {font-family:Tahoma, Arial,sans-serif; font-size:12pt; font-weight:bold; padding- 
bottom:5pX { 

.cite {font-family:Tahoma, Arial,sans-serif; font-size:Spt{ 

/>style></head< 

>body bgcolor="#ffffff<" 

>span class="heading">Simple Single-Value Data Binding</span><hr</ 


>form runat="server<" 

>table border="0<" 

>tr><td nowrap="nowrap<" 

>b>&lt;ASP:Label&gt;</b> control: 

>ASP:Label Text="<%# ImageURL %>" runat="server" /><p</ 


>b>&lt;ASP:TextBox&gt;</b> control: 
>ASP:TextBox Text="<%# ImageURL %>" runat="server" /><p</ 


>b>&lt; ASP:Button&gt;</b> control: 
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>ASP:Hyperlink Text="<%# ImageURL %>" NavigateUrl="<%# ImageURL %>" runat="server" 
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>ASP:Button Text="<%# ImageURL %>" runat="server" /><p</ 


>b>&lt;ASP:LinkButton&gt;</b> control: 
>ASP:LinkButton Text="<%# ImageURL %>" runat="server" /><p</ 


>b>&lt;ASP:Image&gt;</b> control: 
>ASP:Image Src="<%# ImageURL %>" ImageAlign="middle" runat="server" /><p</ 


>b>&lt;ASP:CheckBox&gt;</b> control: 
>ASP:CheckBox Text="<%# ImageURL %>" runat="server" /><p</ 


>b>&lt;ASP:RadioButton&gt;</b> control: 
>ASP:RadioButton Text="<%# ImageURL %>" runat="server" /><p</ 


>b>&lt;ASP:Hyperlink&gt;</b> control: 

/><p</ 

>b>&lt;ASP:ImageButton&gt;</b> control: 

>ASP:ImageButton ImageUrl="<%# ImageURL %>" runat="server</ " 

/>td><td nowrap="nowrap">&nbsp; &nbsp; &nbsp;</td><td nowrap="nowrap<" 
HTML <b>&lt;span&gt;</b> element: 

>span><%# ImageURL %></span><p</ 


HTML <b>&lt;input type="text" &gt;</b> element: 
>input type="text" value="<%# ImageURL %>" /><p</ 


HTML <b>&lt;input type="submit" &gt;</b> element: 
>input type="submit" value="<%# ImageURL %>" /><p</ 


HTML <b>&lt;button&gt;</b> element: 
>button><%# ImageURL %></button><p</ 


HTML <b>&lt;jimg&gt;</b> element: 
>img srec="<%# ImageURL %>" align="middle" /><p</ 


HTML <b>&lt;input type="checkbox"&gt;</b> element: 
>input type="checkbox" /><%# ImageURL %><p</ 


HTML <b>&lt;input type="radio"&gt;</b> element: 
>input type="radio" /><%# ImageURL %><p</ 


HTML <b>&lt;jakgt;</b> element: 
>a href="<%# ImageURL %>"><%# ImageURL %></a><p</ 


HTML <b>&lt;button&gt;</b> and <b>&lt;jimg&gt;</b> elements: 
>button><img src="<%# ImageURL %>"></button< 
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/>td><l/tr< 
/>table< 


/rform< 


>script language="vb" runat="server<" 


ReadOnly Property ImageURLÛO As String 
'declare a read-only property for the Page 
Get 

Return "myimage. gif" 

End Get 

End Property 


Sub Page_Load() 

'bind all the controls on the page 
Page.DataBind() 

End Sub 


/>script< 


/>body< 
/>html< 


بعد تحديد كتلة ربط البيانات في الصفحةء يتوجب علينا تفعيل الربط وذلك عند انطلاق حدث ما (غالباً مايكون 
حدث تحميل الصفحة) لإدراج القيم المناسبة. 

إذ يجري إهمال كتلة الربط من قبل محرك ۸5۴ أثناء ترجمة الصفحة» إذا لم يجري التفعيل» ولا يجري 
عندها استبدال كتل الربط بالقيم المطلوبة. 


تجري عملية تفعيل الربط باستخدام طريقة 04481١١‏ المتوفرة في أكثر من سوية ضمن هرمية الصفحة. 
- لربط جميع عناصر التحكم ضمن الصفحة نستخدم الطريقة 04481١١0‏ الخاصة بالغرض هوه۴. 
هي الطريقة الوحيدة الفعالة في حال استخدام كتلة الربط مع عناصر غير مصممة لربط البيانات (مثل 
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تأشيرات ا 1۲). 

- لربط عنصر تحكم وحيد فقط نستخدم الطريقة 02481١١‏ لهذا العنصر فقط وتستخدم فقط في عناصر 
التككم المصممة خضيصا للتعامل مح ربط لباتات. 

- لربط صف أوعنصر من غرض من مصدر بيانات في عنصر تحكم نستخدم الطريقة 0248٣١‏ لهذا 
الغرض. وهذه الطريقة كسابقتها لا تطبق إلا على العناصر المخصصة للتعامل مع ربط البيانات. 


ربط البيانات ذات القيم المتكررة 


تعتبر عملية ربط البيانات بقيمة وحيدة تقنية مفيدة. ولكن ربط البيانات كتقنية يصبح أكثر أهمية عند وجود 
صفوف متكررة من القيم التي نريد إظهارهاء مثل مجموعة من الصفوف من قاعدة بيانات علائقية أو من 


توفر ۸5۲.٤1‏ ثماني عناصر تحكم قوائم جرى تصميمها للعمل مع القيم المتكررة حيث تملك مجموعة من 
الخصائص والطرق التي تسمح لها بالاتصال بمصادر البيانات. ثم تقوم بصورة آلية بإنشاء عنصر إظهار أو 


كمثال على ذلك نأخذ عنصر التحكم من قائمة >5E1٤8٣1<‏ الذي يقوم بإنشاء العدد المناسب من عناصر 


تتلخص أحد الميزات الواضحة في هذه التقنية في عدم اضطرارنا إلى كتابة أي نص ۲۷×1[ بنفسنا لإظهار 
هذا التصميم» إذ يجري إنشاؤه بشكل آلي من قبل عنصر التحكم (مع احتفاظنا بالطبع بالقدرة على إضافة 


عناصر تحكم القوائم المصممة للتعامل مع الربط المتكرر: 

نستعرض فيما يلي العناصر الثمانية المصممة لاستخدام ربط البيانات من جهة المخدم: 

۰ عنصر التحکم >5٤] ٤٣1<‏ وھو یستخدم lنصdز system.web.ui.htmlControls.htn1Select‏ 
٠‏ عنصر التحكم ×0 18ء۶:11 ۸5 الذي يستخدم صز system.web.ui. WebControls.ListB0x‏ 
٠‏ عنصر التحكم ۷1 0(مها(:۸5۶ الذي يستخدم الصف 
system.web.ui.WebControls.DropDown‏ 

٠‏ عنصر التحكم )ئ1 ×0 86)ءعط €:۸5۶ الذي يستخدم الصف 

system.web.ui.webControls.CheckBox List 
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٠‏ عنصر التحكم )ئ1 P:R adioButt on‏ الذي يستخدم الصف 
system.web.ui.webControls.Radio ButtonList‏ 
٠‏ عنصر التحکم ۸S۲: epee‏ الذي يستخدم صز system.web.ui.webControls.Repeter‏ 


عنصر التحكم ئ1 )a‏ ۸5۶:52 الذي یستخدم lنصز system.web.ui.webControls.Data List‏ 
۰ عنصر التحکم ۲1۵ 2)46( :۸5۶ الذي یستخدم انٹصز system.web.ui.webControls.DataG1id‏ 


تعتبر عملية ربط البيانات بقيمة وحيدة تقنية مفيدة. ولكن ربط البيانات كتقنية يصبح أكثر أهمية عند وجود 
صفوف متكررة من القيم التي نريد إظهارهاء مثل مجموعة من الصفوف من قاعدة بيانات علائقية أو من 


توفر ۸5۶.٤1‏ ثماني عناصر تحكم قوائم جرى تصميمها للعمل مع القيم المتكررة حيث تملك مجموعة من 
الخصائص والطرق التي تسمح لها بالاتصال بمصادر البيانات. ثم تقوم بصورة آلية بإنشاء عنصر إظهار أو 


كمثال على ذلك نأخذ عنصر التحكم من قائمة >5٤E18٣1<‏ الذي يقوم بإنشاء العدد المناسب من عناصر 


تنآ ارات ا کے کک اک ق کے اطا ےک ای کی 0 کد ار 
ا الي ا دري وة قك آل من قل عفر اق (ے اقا ا اقفر ع اسا 


عناصر تحكم القوائم المصممة للتعامل مع الربط المتكرر: 

نستعرض فيما يلي العناصر الثمانية المصممة لاستخدام ربط البيانات من جهة المخدم: 

system. web.ui.html1Controls.htm1Select زصنl وهو يستخدم‎ >SE٤ ٤٣1< عنصر التحکم‎ ٠ 
system.web.ui. WebControls.ListB0x عنصر التحكم ×0 ۸5۶:118 الذي يتدم لصف‎ ٠ 
عنصر التحكم ۷1 0(مها(:۸5۶ الذي يستخدم الصف‎ ٠ 


system.web.ui.WebControls.DropDown 
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٠‏ عنصر التحكم ئ1[ ×0 86)ءع €:۸5۶ الذي يستخدم الصف 

system.web.ui.webControls.CheckBox List 

٠‏ عنصر التحكم P:R adioButt on 1s)‏ الذي يستخدم الصف 
system.web.ui.webControls.Radio ButtonList‏ 

عنصر التحكم ۲ع)epe‏ :۸8۶ الذي يستخدم |لصڑز rںsystem.web.ui.webControls.Repete‏ 


عنصر التحكم †ئa1)‏ ۸5۶:5 الذي يستخدم |نصز system.web.ui.webControls.Data List‏ 
۰ عنصر التحکم ۲1١‏ 2)46 :۸5۶ الذي یستخدم انٹصز system.web.ui.webControls.DataGrid‏ 


خصائص عناصر التحكم المرتبطة المتكررة 


جرى تصميم عناصر التحكم لاستخدامها من جهة المخدم بحيث تقدم مجموعة من الخصائص والطرق لإدارة 

عملية الربط. نستعرض فيما يلي لائحة بهذه الخصائص: 
الخاصة وصف 
DataTextField‏ تحدد حقل أو عمود مصدر البيانات الذي يحتوي على القيم 
الى د فارعا ى مل ل لق ام 
ضمن عنصر التحكم <١0۴P1۲10>كنص‏ للعنصر 

ListBox. 

DataValueField‏ تند حل أ عمود مصدر البيانات الذي يحتوي القيم التي 

في العناصر التابعة 41.0۴ ۷ستستخدم من أجل الخاصة 

لعنصر التحكم. على سبيل المثال القيم المستخدمة في الخاصة 

التابعة لعنصر التحكم <110 0< لعناصر VALUE‏ 

ListBox. 

DataTextFormatSt‏ تحدد تنسيق سلسلة المحارف المستخدمة مع القيم المحددة من 

عند tءا[)×١٥‏ 441( العمود أو الحقل المشار إليه بالخاصة 

اهار كه الق كن اضر على ميل المقل اك 

“]0:€[ لتنسيق العملة أو‎ “0:44 MMMM 

لتنسيق التاريخ. (رررر,ل 

DataMember‏ تحدد مجموعة الصفوف التي سيتم الربط بها عند احتواء 

مصدر البيانات على أكثر من مجموعة صفوف. على سبيل 

۰ CÉاامثال‏ اسم الجدول عند الربط مع غرض 
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طرق وأحداث عناصر التحكم المرتبطة المكررة 


تقدم جميع عتاصر التحكم المصممة للتعامل مع القيم المكررة طريقتين على الأقل للاستخدام مع البيانات 
المرتبطة: 
الطريقة الوصف 
بملء عناصر التحكم بالبيانات من تقوم 
مصادر البيانات أي باختصار تفعيل الربط 


DataBind 
الذي قمنا بضبطه اثناء التصريح عن‎ 
يستخدم لاستعادة مؤشر إلى عنصر التحكه‎ 
لی‎ FindControl 


الابن ضمن عنصر التحكم المرتبط. 


الأحداث الخاصة بعناصر التحكم المرتبطة المكررة: 
هناك مجال واسع للأحداث التي يتم إطلاقها بواسطة عنصر تحكم قائمةء يتعلق بعضها بنو ع عنصر التحكم 
.على كل حال هناك حدثان مشتركان بين أنواع عناصر تحكم القائمة المصممة لربط البيانات: 
الحدث الصف 
يظهر هذا الحدث من أجل كل صف في 
مصدر البيانات. يتم تمرير محتوى الصف 
DataBinding‏ إلى الحدث ضمن معاملات الحدث حيث 
يمكن فحص وتعديل بيانات الصف أثناء 
ملء عنصر التحكم بالمعلومات. 
يظهر هذا الحدث عندما يتم إرسال الصفحة 
مع العناصر المختارة إلى المخدم“ وهو 
يسمح للنص البرمجي بإجراء التغييرات 
على الإظهار لتعكس خيارات المستخدم. 


SelectedindexChange 


مصادر البيانات لربط القيم المتكررة 
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بعد أن اطلعنا على عناصر التحكم سنستعرض فيما يلي مصادر البيانات التي يمكن ربطها بهذا النوع من 
اخاض: 


يمكن من الناحية الفنيةء ربط عناصر تحكم القوائم إلى أي نوع من مصادر البيانات التي تستخدم 
Collection »/Enumerable‏ أو Source‏ kİstاا‏ . هذا يعني من الناحية العملية أن عناصر تحكم القوائم 
يمكن ربطها إلى: 

Collection‏ مثل مجموعة القيم الخاصة ب 651.۴0۲۳١‏ ا۸R۴Q‏ أو مجموعة الجداول في غرض 
ts‏ أو أي مجموعة ننشأها بأنفستا 

* أكأال۸۲۲۵: وهي تحتوي مجموعة بسيطة من القيم. وهي طريقة جيدة عموماً إذا كنا نريد إظهار 
خیارات في ×80 أا مثلا 

مeاطa‏ ا :Hash‏ تحتوي عناصر يمكن الوصول إليها عبر مفتاح كحال الغرض ۸2۲۷ ٥|ا0i.‏ يكون 
لكل عنصر مفتاح وقيمة مما يجعل مصادر البيانات هذه مثالية في حالة عناصر تحكم القوائم حيث يختلف 
النص المراد إظهاره عن القيمة المراد إعادتها عند اختيار عنصر 

٠‏ غرض ۷16Wهه(:‏ يحتوي هذا الغرض على صفوف من أغراض اط1 هاه( يجري تأهيلها من 
عة قات وجري رها راما كى عن شرن ال افرمين 

٠‏ غرض :(24۸88406١‏ الذي يوفر اتصال مخصص للقراءة وباتجاه واحد مع قاعدة البيانات. يمكن 
أن يحوي صف أو مجموعة صفوف ويتم التعامل معه بصورة مشابهة لما يحصل مع غرض Wء2۷iأج0‏ . 
نستخدم عادة الغرض 048۸٠406١‏ لأغراض الأداء حيث يكون أداء الغرض 048۸٠406۲‏ أسرع في 
أغلب الحالات 


صيغة استخدام ربط البيانات للقيم المتكررة 
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عند ربط عنصر التحكم بقيمة وحيدة كحال الربط مع خاصة أو الربط مع القيمة المعادة من طريقة بالصيغة: 


<%# name-of-data-source %> 


تحتوي مصادر البيانات المرتبطة بقيم متكررة على أكثر من حقل. ففي حال كان مصدر البيانات من النوع 
ما Hash‏ الذي يحتوي على مفتاح وقيمة أو كان من النو ع 08۲ 04۸6ء يجب أن نكون قادرين 
على تحديد العمود أو الحقل المراد ربط عنصر التحكم إليه. 


تكون كثير من عناصر تحكم القوائم قادرة على إظهار أكثر من قيمة لكل عنصر في القائمة. فعلى سبيل 
المثالء نستطيع في العنصر <آ 0 51> استخدام قيمة لمحتوى العنصر <ل١۲|0‏ 0۴> وقيمة للخاصة 
۴ل AL‏ لھذا العنصر. 
<SELOCEZ‏ 
<Option Value=”Valuel”> Text1</Option>‏ 


GOOELOA VALUE= AMALUSO24S TOESEZ2S/OIE LORS 
€/ SELECES 


إسقاط الحقول من مصدر البيانات على خصائص عنصر التحكم: 

هناك طريقتان لإسقاط أو وصل حقل محدد من كل صف في مصدر البيانات إلى خصائص عنصر تحكم. 
يعتمد اختيار الطريقة على عنصر التحكم الذي نقوم بربطه: 

- إذا كان عنصر التحكم يدعم القوالب يمكننا التصريح عن قالب لكل صف سيتم إظهاره من قبل عنصر 
التحكم. 

- إذا كان عنصر التحكم لا يدعم القوالب نستطيع إسناد الحقول في مصدر البيانات إلى خصائص عنصر 
التحكم بضبط الخصائص أثناء عمل البرنامج. 


تكون عناصر التحكم في ۸5۴.٤۲‏ التي تدعم لتوب DataGrid ş DataList «Repeater :aa‏ 
وعليهء يمكننا لأي من هذه العناصر التصريح عن قالب ووضع تعليمات ربط البيانات ضمنه. 


Key:<$%# Container.Dataltem.Key$%> 
أو‎ 
Valle: <sCONEaIMEE Dalal E eM Val Uê s> 


عند الربط مع أغراض ١0|أء|ااهع‏ أو ata ۷ew‏ أو ata Reader‏ نحدد الخاصة»ء الحقل أو العمود 


نفسه: 
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Valine ErOM Mala em/ Dall AReaAGeEK E <S COMER Dalal EemM (OSO KN ame) 
%> 

أو 
WALLS EEO COLLSCELALON:S <S CONEAALNEE. DACALEM(ZEOLCOLOLLZ), £>‏ 


مثلا نستطیع استخدام عنصر تحکم a26۲٥م٥۸‏ لإظھار قیم ۸٥y‏ و ۷ale‏ ضمن غرض eاطa‏ 1 :Hash‏ 
<ASP:Repeater id="MyRepeater" runat="server">‏ 

<IEEMTEemplatez> 

<%# Container.Dataltem.Key %> = 

<%# Container.Dataltem.Value %><br /> 

</ItemTemplate> 

</ASP:Repeater> 


صيغة استخدام ربط البيانات للقيم المتكررة 
عند ربط عنصر التحكم بقيمة وحيدة كحال الربط مع خاصة أو الربط مع القيمة المعادة من طريقة. 


تحتوي مصادر البيانات المرتبطة بقيم متكررة على أكثر من حقل. ففي حال كان مصدر البيانات من النوع 
ما Hash‏ الذي يحتوي على مفتاح وقيمة أو كان من النو ع 024۸6208۲ يجب أن نكون قادرين 
على تحديد العمود أو الحقل المراد ربط عنصر التحكم إليه. 


تكون كثير من عناصر تحكم القوائم قادرة على إظهار أكثر من قيمة لكل عنصر في القائمة. فعلى سبيل 
لمل اطم ا ۲۶ 46186 اتك فة مى لسر ء266۳106 رقم الكاة 
٤۴ل AL‏ لهذا العنصر. 


إسقاط الحقول من مصدر البيانات على خصائص عنصر التحكم: 

هناك طريقتان لإسقاط أو وصل حقل محدد من كل صف في مصدر البيانات إلى خصائص عنصر تحكم. 
يعتمد اختيار الطريقة على عنصر التحكم الذي نقوم بربطه: 

- إذا كان عنصر التحكم يدعم القوالب يمكننا التصريح عن قالب لكل صف سيتم إظهاره من قبل عنصر 
التحكم. 

- إذا كان عنصر التحكم لا يدعم القوالب نستطيع إسناد الحقول في مصدر البيانات إلى خصائص عنصر 
التحكم بضبط الخصائص أثناء عمل البرنامج. 
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تكون عناصر التحكم في ۸5۶۴.٤۲‏ التي تدعم القوانفب DataGrid ş DataList «Repeater :aa‏ 
وعليه»ء يمكننا لأي من هذه العناصر التصريح عن قالب ووضع تعليمات ربط البيانات ضمنه. 


إسقاط أو وصل الحقول بصورة ديناميكية أثناء العمل 
اداد عار اك ا ف ا اه ر خط ف الكسان فال د 


الخصائص اسم الحقل من مصدر البيانات الذي سيتم إظهاره في الخر ج (الخاصة (DataTextField‏ 
والحقل الذي سيعطي القيم غير الظاهرة لعنصر التحكم (الخاصة .(DataValueFie|d‏ 


ويعتبر عنصر التحكم DataGrid‏ ڪا بشکل کافي أتحديد الحقول من مصدر البيانات بصورة آلية وإظهار 
جميع القيم. يعمل هذا الحل عندما يكون مصدر llبيlنlت DataSet «DataView «Array gk‏ « 
hata Reader‏ ولکن لا يعمل في حال کان مصدر البيانات هو e٥اطھ‏ ۲ .Hash‏ 


إسقاط أو وصل الحقول بصورة ديناميكية أثناء العمل 
ع اک ا ام اا لے ١‏ ف ارات ادن خا ف اتان امن هه 
الخصائص اسم الحقل من مضدر البيانات الذي سيتم إظهارء في الخر ج (الخاصة لاهأ1۴ ٣٠×‏ ة5a)‏ 


والحقل الذي سيعطي القيم غير الظاهرة لعنصر التحكم )ائخاصة .(DataValueField‏ 


ويعتبر عنصر التحكم lù DataGrid‏ بشكل كافي لتحديد الحقول من مصدر البيانات بصورة آلية وإظهار 
جميع القيم. يعمل هذا الحل عندما کون مصدر llبيlنlت DataSet «DataView «Array gk‏ « 
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.H1ےash‎ ۲ ھطا٥e ولکن لا يعمل في حال کان مصدر البیانات ھور‎ Data Reader 


تقییم التعبیرات بالطریقة اھ۷ ٤‏ 


يمكن أن تحتوي كتلة ربط البيانات في عناصر التحكم التي تستخدم القوالب أمثلة من التعبير التالي أو مشتقات 
عنها: 


E COREALNEE ,DACALECEM (EFIELAMMEZA), £> 


يُعتبر استخدام طريقة اج۷ الخاصة بالغرض 04481١۵6١‏ أحد المشتقات الشائعة لتحديد قيمة ضمن 
مصدر البيانات» في حال احتوائه على أكثر من قيمة ضمن الصف. ويمنح خيار تنسيق القيمة لإظهارها. 


هناك تلاث وسائل نستطيع فيها استخدام الطريقة اج٤‏ : 

- عند احتواء كل صف من القائمة ضمن مصدر البيانات على أكثر من قيمة (أكثر من حقل أو عمود). 
على سبيل المثال صف من W٥۷1هاه‏ 0 مرتبط بجدول من قاعدة بيانات أو غرض اط2 ۸۲ءج١.‏ 

- عند الرغبة باستخدام غرض مختلف عن ذلك المرتبط بعنصر التحكم كمصدر للقيمة. 

- عندما نريد تنسيق قيمة عند إظهارها. على سبيل المثال أخذ قيمة عددية وتنسيقها كعملة. 


ر ا ر من رة ا ك اة المت ما و تخر كما فش موت 
موضو ع الأداء. في المثال التالي نريد القيمة من العمود المسمى ٠|اأأ‏ )800 من الصف في غرض 
:DataView‏ 


DataBinder.Eval (Container.Dataltem, “BookTitle”) %>‏ #%< 
تستخدم الطريقة E۷۵‏ تقنية تدعى الربط المتأخر بعد تقييم التعبير مما يخلق حمل أعلى نسبة إلى الطريقة 
التي ال تة 


أا الطركة القامة لاستكد ام اداع فتتخدم عنما ذرنة الربظ إلى غرض غير معرف في الخاصة 
06ط لعنصر التحكم. يسمح لنا ذلك بالتأشير إلى قيم معينة في هذا الغرض سيتم استخدامها في كل 
صف يتم إظهاره. فعلى سبيل المثال إذا كان لدينا غرض 04۷16۷ باسم 4أ1۷22¡٧‏ زا0 يحتوي 
معلومات حول المدن نستطيع تحديد قيمة العمود ۷4۳8© في الصف الرابع من الغرض Wء2۷iج5‏ 


باستخدام: 


SE Mala BAEC. Bal (OBE EDalE a, NS CTEvName ll) o> 
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من أكثر تطبيقات الطريقة اه۷ فائدةء استخدامها لتنسيق القيم المراد إظهارها وهذا ما سنراه في الشريحة 
التالية. 


يُعتبر استخدام طريقة اج۷ الخاصة بالغرض 04481١۵46١‏ أحد المشتقات الشائعة لتحديد قيمة ضمن 
مصدر البيانات» في حال احتوائه على أكثر من قيمة ضمن الصف. ويمنح خيار تنسيق القيمة لإظهارها. 


هناك تلاث وسائل نستطيع فيها استخدام الطريقة اج۷ع: 

- عند احتواء كل صف من القائمة ضمن مصدر البيانات على أكثر من قيمة (أكثر من حقل أو عمود). 
على سبيل المثال صف من W٥۷1هاه0‏ مرتبط بجدول من قاعدة بيانات أو غرض ءاط2ة۸۲ءج١.‏ 

- عند الرغبة باستخدام غرض مختلف عن ذلك المرتبط بعنصر التحكم كمصدر للقيمة. 

- عندما نريد تنسيق قيمة عند إظهارها. على سبيل المثال أخذ قيمة عددية وتنسيقها كعملة. 


تعتبر الطريقة الأولى من الطرق السابقة امتداداً للصيغة المستخدمة سابقاً ولا تضيف عليها شيئًا سوى 
موضوع الأداء. 

تستخدم الطريقة اه۷ تقنية تدعى الربط المتأخر بعد تقييم التعبير مما يخلق حمل أعلى نسبة إلى الطريقة 
التقليدية المستخدمة. 


أا الطريقة أقاة لمتكا اةباع فتك عدا ترك الربط لى غركن غير معرف قى الخاسة 
t20 €‏ لعنصر التحكم. يسمح لنا ذلك بالتأشير إلى قيم معينة في هذا الغرض سيتم استخدامها في كل 
صف یتم إظهاره. 


من أكثر تطبيقات الطريقة ا۷2 فائدةء استخدامها لتنسيق القيم المراد إظهارها وهذا ما سنراه في الشريحة 
التالية. 

تنسيق القيم باستخدام طريقة اج۷ع: 
تأخذ الطريقة اج۷٤‏ ثلاث معاملات يكون الأخير منها وهو 10۲۳5۲١9‏ الذي يحدد تنسيق الخرج» غير 


إجباري. فعلیى سبیيل المتال نستطيع تحديد محتو ى الحقل ۸۴٥۱١‏ ٥ااهiاطا۴‏ من مصدر البيانات الذي نود 
إظهاره بتنسیق تاریخ نظامي باستخدام الصيغة: 
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OTT 


WELLOLL LCEIE LOMDEE GY , 


Dataltem, 


DataBinder.Eval (Container. 


تكون النتيجة من الشكل ”2006 لالاز 10“ (حسب الإعدادات الإقليمية للمخدم). 


E Dy Cas 


التالي فهو الذي يعير عن التنسق ET‏ 


فيمايلي نسرد أهم التنسيقات المستخدمة: 


التنسيقات العددية: 
المحرف المستخدم 


o. 


e 


Corc 
Dor d 


E ore 


F or f 
Gor g 
N or n 
P or p 


X Or Xx 


أما مع التاريخ فنستخدم: 
المحرف المستخدم 


- a 


e 


d 
D 
f 


5) 


122 


الوصف 


Currency format 
Decimal format 
Scientific 
(exponential) 
format 
Fixed-point format 
General format 
Number format 
Percent format 
Hexadecimal 
format 


الوصف 


Short date 
Long date 
Full (long date and 
short time) 
Full (long date and 
long time) 
General (short 
date and short 
time) 


مثال 


$1,234.60, ($28.15), 
205, 17534, -65 


3.46E+21, -1.2e+3, 
3.003E-15 


34.300, -0.0 
Depends on actual value 
3,456.23, 12.65, -1.54 
45.6%, -10% 
&H5f76, 0x4528 (depends 
on actual value) 


مثال 


M/d/yyyy 
dddd, MMMM dd, yyyy 


dddd, MMMM dd, yyyy 
HH:mm aa 


dddd, MMMM dd, yyyy 
HH:mm:ss aa 


M/d/yyyy HH:mm aa 


تنسيقها) » أما الحرف 
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General (short 


M/d/yyyy HH:mm:ss aa date and long G 
time) 
MMMM dd Month and day M or m 


ddd, dd MMM yyyy 
HH:mm:ssGMT RFC1 123 format R Orr 
ISO 8601 sortable 


-MM-dd HH: : ت‎ 
TSM BIDS using local time 


HH:mm aa Short time 
ISO 8601 sortable 
yyyy-MM-dd HH:mm:s using universal u 
time 
dddd, MMMM dd, yyyy Universal sortable U 
HH:mm:ss aa date/time 
MMMM, yyyy YoOFry 


Year and month 


من الممكن يشا استخدام البكحارف فى الجدرل التالىلإنقاء ضدورة لقم رقية فعلى ميل المثال برلد سيق 
##.00#'" عند التطبيق على الرقم 1.2345 الرقم "001.23'". فإذا كنا نريد تحديد قيم موجبة أو سالبة 
وصفرية» فإننا نقوم بفصلها عن بعضها البعض باستخدام فاصلة منقوطة. 


ا باستخدام عبار ة تسق من الشكل: 
“O00#.##:;(OO0#.##);[O]”‏ 
فطع الول غلی 
”(001.2)“ للرقم 1.2345- و ”[0]“ للرقم صفر. 
EE‏ ف 
يقوم بإظهار صفر إذا لم يكن هناك قيمة أو 
0 يضف صقرا ماه أرق اريه اضفار 
عقرية لشاف به افامااة رة 
يحل محله أي رقم ويهمل أي ظهور لهذا 
المحرف إذا لم يوجد رقم مرتبط 
تظهر نقطة عشرية 
% ار خرف 4 
E+0, E-0,‏ 


O‏ أو تقوم بتنسيق الخر ج بالنمط 


مادختسابE‎ 


| تقوم بإظهار المحارف بعدها كما هي بغض 
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أو 


النظر عن كونها محارف تنسيق. 
يتم إظهار أي مجموعة محارف محتواة كما 
هي هي بغض النظر عن کونها محارف 


0 


للسيقى . 


تأخذ الطريقة اج٤‏ ثلاث معاملات يكون الأخير منها وهو ٣١ ٣9‏ ا١١۲٥‏ الذي يحدد تنسيق الخرج» غير 
إجباري. 


1.7-6متال عن ربط البيانات بقيمة مكررة. يجري استخدام ArrayList‏ تم إنشاؤه وملؤه بالقيم ضمن 
معالج الحدث ل1.02_ءPag:‏ 
Simple Repeated-Value Data Binding‏ 


< ASP:RadioButtonListz control: 


124 


2 ASP:DataList> control: 
Microsoft 

Sun 

IE 

Lampag 

racle 


+ A SP:CheckBaxList> control: 


FT Microsoft 
FT Sun 

FT IEM 

I Compaq 
FT oracle 


` Microsoft 
"Sun 

` IBM 

` Cormpaq 
` Oracle 


HTL <select element: 
| Microsoft <| 


< ASP:DropDownList> control: 
[Microsoft 3 


<+ ASP:ListBoxz control: 
vicroasofl & 


> ASP:DataGrid> control: 
Item 

Microsoft 

Sun 

IBI 

Lompagq 

Orace 


<ASP:Repeater > control: 
Microsoft Sun IEM Compaq Oracle 
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نلاحظ في جز ء 1101 الخاص بهذه الصفحة» أننا قمنا بالتصريح عن ثماني عناصر تحكم قوائم. 
يمكننا رؤية ذلك lnı‏ عد .DataList , Repeater‏ 
كل ما نفعله هو تعريف عنصر التحكم نفسه: 


HTML <b>&@lt;select&gt; </b> element: <br /> 

<select id="MySelectList" runat="server" /><p /> 
<b>&lt;ASP:DropDownList&gt; </b> control: < br /> 
<ASP:DropDownList id="MyDropDown" runat="server" /><p /> 
<b>8&lt;ASP:ListBox&gt; </b> control: <br /> 

<ASP:ListBox id="MyASPList" runat="server" /><p /> 
<b>&lt;ASP:DataGrid&gt; </b> control: <br /> 

<ASP:DataGrid id="MyDataGrid" runat="server" /><p /> 
<b>&lt;ASP:Repeater&gt; </b> control: <br /> 
<ASP:Repeater id="MyRepeater" runat="server"> 
<ItemTemplate> 

<%# Container.Dataltem %> 

</ItemTemplate> 

</ASP:Repeater> <p /> 

<b>&lt;ASP:DataList&gt; </b> control: <br /> 

<ASP:DataList id="MyDataList" runat="server"> 
<ItemTemplate> 

<%# Container.Dataltem %> 

</ItemTemplate> 

</ASP:DataList> <p /> 

<b>&lt;ASP:CheckBoxList&gt; </b> control: <br /> 
<ASP:CheckBoxList id ="MyCheckList" runat="server" /><p /> 
<b>&lt;ASP:RadioButtonList&gt; </b> control:< br /> 
<ASP:RadioButtonList id ="MyRadioList" runat="server" /><p /> 


أما بالنسبة إلى إعا2ع2مءR‏ و اء1اه)ة( فهما يتطلبان تحديد الخرج الذي نريد للعناصر المكررة لذلك قمنا 


ڊإدر اج <ItempTemplate>‏ . 


ا كان ما ندرجه ضمن <ع12م۳١‏ 1م .ع)[> فسيجري تنفيذه بعدد العناصر المكررة. نقوم في النص 
البرمجي بتحديد عنصر البيانات نفسه فقط ونضع القيمة لهذا العنصر ضمن )ء1 ۸۲۲۵۷. 

بالنسبة للنص البرمجي الخاص بمعالجة حدث تحميل الصفحة»ء نقوم ببساطة بإنشاء )ئ۸۲۲۵ ونملؤها 
بخمس قيم من سلاسل المحارف» ونقوم بإسناد الغرض 1 ,ه۸۲۲ كقيمة للخاصة ع٥‏ 50uه)a(‏ لعناصر 


التحكم. ثم نقوم بربط البيانات. 
Sub Page_Load()‏ 
'create an ArrayList of values to bind to‏ 
Dim arrValues As New ArrayList(4)‏ 
arrValues.Add("Microsoft")‏ 
arrValues.Add("Sun")‏ 


arrValues.Add("IBM”") 
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arrValues.Add("Compaq”") 
arrValues.Add("Oracle") 

'set the DataSource propert of the controls to the array 
MySelectList. DataSource = arrValues 
MyDropDown.DataSource = arrValues 
MyASPList.DataSource = arrValues 
MyDataGrid.DataSource = arrValues 
MyRepeater.DataSource = arrValues 
MyDataList. DataSource = arrValues 
MyCheckList. DataSource = arrValues 
MyRadioList. DataSource = arrValues 
'bind all the controls on the page 
Page.DataBind() 

End Sub 


مثال عن ربط البيانات بقيمة مكررة يستخدم Hash 141e‏ 


Universal Knowledge Solutions s.a.1 126 


HTML <selectz> elements: 


Sun 2 [28.33 "| < ASP:DataList> control: 
‘SuMm' - Yale: 2,833000E+001 
< A SP :DropDownList> controls: TEM" - value: 5,SOOOODE+O01 
[Sun >| 28.33 3 Oracle" - Yale: 4, 110000E+001 
‘Microsoft = vale: 4,45600OE+001 
<ASP:ListBox> controls: ‘Compaq! - value: 2.074000E+001 


< ASP:CheckBoxList= control: 


TF Sun 

[ IM 
< ASP:DataGrid> control: [` Oracle 
key Yalue ` Microsoft 
Tg F28.33 ita HE 


IBY ESS. 
Graclê £41.10 
Microsoft £49, 56 
Compaq £20.74 


< ASP:RadiaButtanList> control: 
f” Percentage rate 28.33% 
f" Percentage rate 55.00% 


ASP:Repeater> control: " Percentage rate 41, 10%‏ ك 
Sun = 28,33‏ 

JEM = 55 f" Percentage rate 49,5% 
Oracle = 41,1 (` Percentage rate 20.74% 


Microsoft = 44,56 
pa۹ = .لے‎ 74 


في جز ء 111 الخاص بهذه الصفحة نلاحظ أننا قمنا بالتصريح عن ثماني عناصر تحكم قوائم. 
يمكننا رؤية ذلك .DataList , Repeater |e Inıè‏ 
كل ما نفعله هو تعريف عنصر التحكم نفسه: 


HTML <b>&@lt;select&gt; </b> elements:<br /> 
<select id="MySelectList1" runat="server" /> &nbsp; 
<select id="MySelectList2" runat="server" /><p /> 
<b>&lt;ASP:DropDownList&gt; </b> controls: < br /> 
<ASP:DropDownList id="MyDropDown1" runat="server" /> &nbsp; 
<ASP:DropDownList id="MyDropDown2" runat="server" /><p /> 
<b>8&lt;ASP:ListBox&gt; </b> controls:< br /> 
<ASP:ListBox id="MyASPLiIst1" runat="server" /> &nbsp; 
<ASP:ListBox id="MyASPList2" runat="server" /><p /> 
<b>&lt;ASP:DataGrid&gt; </b> control: <br /> 

<ASP:DataGrid id="MyDataGrid" runat="server" AutoGenerateColumns="false"> 
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<Columns> 

<ASP:BoundColumn HeaderText="Key" DataField="Key" /> 
<ASP:BoundColumn HeaderText="Value" DataField="Value" 
DataFormatString="{0:C}" /> 

</Columns> 

</ASP:DataGrid> <p /> 

<b>&lt;ASP:Repeater&gt; </b> control: <br /> 
<ASP:Repeater id="MyRepeater" runat="server"> 
<ItemTemplate> 

<%# Container.Dataltem.Key %o> = 

<%# Container.Dataltem.Value % ><br /> 

</ItemTemplate> 

</ASP:Repeater> <p /> 

<b>&lt;ASP:DataList&gt; </b> control: <br /> 

<ASP:DataList id="MyDataList" runat="server"> 
<ItemTemplate> 

'<%# Container.Dataltem.Key %>'- value: 

<%# DataBinder.Eval(Container. Dataltem, "Value", "{0:E}") %> 
</ItemTemplate> 

</ASP:DatalList> <p /> 

<b>&lt;ASP:CheckBoxList&gt; </b> control: <br /> 
<ASP:CheckBoxList id ="MyCheckList" runat="server" /> <p /> 
<b>&lt;ASP:RadioButtonList&gt; </b> control:< br /> 
<ASP:RadioButtonList id ="MyRadioList" runat="server" /><p /> 
<ASP:DataGrid id="MyDataGrid" runat="server" AutoGenerateColumns="false"> 
<Columns> 

<ASP:BoundColumn HeaderText="Key" DataField="Key" /> 
<ASP:BoundColumn HeaderText="Value" DataField="Value" 
DataFormatString="{0:C}" /> 

</Columns> 

</ASP:DataGrid> 


.<item'Template> pدختwi‎ DataList gy Repeater رصاlie لربط‎ y 


نلاحظ استخدامنا لعنصر البيانات ر٥×‏ وعنصر البيانات عں[ھ۷ کوننا نتعامل مع .Hash 1 able‏ 


<b>&lt;ASP:Repeater&gt; </b> control: <br /> 
<ASP:Repeater id="MyRepeater" runat="server"> 
<ItemTemplate> 

<%# Container.Dataltem.Key %o> = 

<%# Container.Dataltem.Value % ><br /> 
</ItemTemplate> 

</ASP:Repeater> <p /> 
<b>&lt;ASP:DataList&gt; </b> control: <br /> 
<ASP:DataList id="MyDataList" runat="server"> 
<ItemTemplate> 

'<%# Container.Dataltem.Key %>'- value: 

<%# DataBinder.Eval(Container.Dataltem, "Value", "{0:E}") %> 
</ItemTemplate> 

</ASP:DataList> <p /> 


اكوا لملء غرض 1ا12 يه[ بالبيانات نستخدم معالج الحدث 024]_ءع۴a:‏ 


Sub Page_Load() 
'create a HashTable of values to bind to 
Dim tabValues As New HashTable(5) 


tabValues.Add("Microsoft", 49.56) 
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tabValues.Add("Sun", 28.33) 
tabValues.Add("IBM", 55) 
tabValues.Add("Compaq", 20.74) 
tabValues.Add("Oracle", 41.1) 

'first <select> displays the Keys in the HashTable 
MySelectList1.DataSource = tabValues 
MysSelectList1.DataTextField = "Key" 

'second one displays the Values in the HashTable 
'and uses the Keys as the <option> values 
MySelectList2.DataSource = tabValues 
MySelectList2.DataValueField = "Key" 
MySelectList2.DataTextField = "Value" 

'same applies to ASP: controls, except here 

'we can also specify the format of the Key 
MyDropDown1.DataSource = tabValues 
MyDropDown1.DataTextField = "Key" 
MyDropDown2.DataSource = tabValues 
MyDropDown2.DataValueField = "Key" 
MyDropDown2.DataTextField = "Value" 
MyDropDown2.DataTextFormatString = "{0:F}" 
MyASPList1.DataSource = tabValues 
MyASPList1.DataTextField = "Key" 
MyASPLiIst2.DataSource = tabValues 
MyASPLiIst2.DataValueField = "Key" 
MyASPLiIst2.DataTextField = "Value" 
MyASPLiIst2.DataTextFormatString = "{0:C}" 


و نحدد لعناصر تڪpĞ Repeater‏ و Dat)‏ مصدر البيانات فقط لأننا حددنا ضمن ع2]اp٣1em Ite‏ 


كيف سيتم إظهار المحتويات. 
MyDataGrid.DataSource = tabValues‏ 


MyRepeater.DataSource = tabValues 
MyDataList. DataSource = tabValues 


أما بالنسبة لعناصر التحكم heck8 0× List‏ و RadioButton List‏ فيكفي تحديد الخصائص 
:lgl DataTextField ş DataValueField‏ 


'in the CheckboxList we'll display the Title and 
'use the Value as the control value 
MyCheckList. DataSource = tabValues 
MyCheckList.DataValueField = "Value" 
MyCheckList.DataTextField = "Key" 

'in the RadioList we'll display and format the 
'Value and use the Key as the control value 
MyRadioList. DataSource = tabValues 
MyRadioList. DataValueField = "Key" 
MyRadioList. Data TextField = "Value" 
MyRadioList. Data TextFormatString = "Percentage rate {0:F}%o" 


و بالطبع يجب ألا ننسى عملية ربط جميع العناصر في الصفحة 


Page.DataBind() 'bind all the controls on the page 
End Sub 


مثال ربط قيمة متكررة إلى غرض Wء۷1هه05:‏ 
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في هذا المثال سنستعرض ربط البيانات إلى غرض ۷ء|۷ه04. سنتعامل مع هذا الغرض فقط كحاوية 
لمجموعة من الصفوف لأننا سنؤجل الحديث عن الاتصال مع قواعد البيانات وكيفية الحصول على البيانات 
ا کن 


Repeated-Value Data Binding to a DataView Object 


HTH select slemani: 
Baginning Bite Sarter 


RP: lstz> controls: 
Eagirnirıg Elite Sefer 


cz ARP-| KHÊnx  ronirnls : 
Eaginnirıg Site Sarter 
Frofaszlonal AEE Frogrammirg 4th ESA Yeblagis Samar 


ASP :DataGrldz control: 
15E Tik FLENEatier [laie 


1ES1OESIA Ba gring Sila Server : OUTErENIN 10:00:00 
1EBIOIZES4S Fras iznal IEEE Fragrammirng with BE, Webloall Serre: OIA OG: 


a ARP: Reapeat ar çort ol: 

Beqînnimqg Site SerYyer' 

EH: 1BBIMOZSD PLblehad: O1 February 2200 
PFolessimal 12EE Programming with HEA Weblogic SeFwEF 
SAH: 18BI Published: Ti Oribrr 2000 


GE : zB EE 


ii - se - QFE O Qerh Fates rea 
لھ‎ #[ ta lilocahoat{ 7O25 | data-bindin gir spezatad- bind naf dataset -biradirag. apie آ*‎ 


2 ASP:Datallstz corral: 
Begining Hite Serwer 
SEH: 18B1DOZ2D Publthad: 11 Fabrulary 2200 


Professimal 12FE Programming with BEA Weblogic Serwer 
SEH: 18B1MZ22 Publlhad: 01 October 2000 


2 RSP: CheckEBoxsList = cant ol! 
FT Beqhning Slike Server 
T7 Professional ]3EE Frag ammung wilh BEA leblagqi Ser ar 


& A BP:RaripRutt origi = control: 
O Ppblishad or Tumafay, February O1, 200O 
T Pblehad or 3Lnday, Drtzbzr DL, aon 


ك 
Wa. E DOE Boao‏ 
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.subhead {font-family:Tahoma,Arial,sans-serif; font-size:12pt; font-weight:bold; padding- 
bottom:Spx } 

.cite {font-family:Tahoma,Arial,sans-serif; font-size:Spt } 

</style></head> 

<body bgcolor="#ffffff"'> 

<span class="heading">Repeated-Value Data Binding to a DataView Object</span><hr /> 


<%'-- insert the control that creates the DataSet --%> 
<wrox:getdataview 1d="ctlDataView" runat="server"/> 


<form runat="server"> 


HTML <b>&lt;select&gt;</b> elements:<br /> 
<select id="MySelectList" runat="server" /><p /> 


<b>&lt;ASP:DropDownlList&gt;</b> controls:<br /> 
<ASP:DropDownList id="MyDropDown" runat="server" /><p /> 


<b>&lt;ASP:ListBox&gt;</b> controls:<br /> 
<ASP:ListBox id="MyASPList" runat="server" /><p /> 


<b>&lt;ASP:DataGrid&gt;</b> control:<br /> 
<ASP:DataGrid id="MyDataGrid" runat="server" /><p /> 


<b>&lt;ASP:Repeater&gt;</b> control:<br /> 

<ASP:Repeater id=" MyRepeater" runat="server"> 

<ItemTemplate> 

<div> 

<b><%# Container.Dataltem(" Title") %></b><br /> 

ISBN: <%# Container.Dataltem("ISBN") %> &nbsp; 

Published: <%# DataBinder.Eval(Container.Dataltem, "PublicationDate", "{0:D}") %> 
</div> 

</ItemTemplate> 

</ASP:Repeater><p /> 

<b>&lt;ASP:DataList&gt;</b> control:<br /> 

<ASP:DataList id="MyDataList" runat="server"> 

<ItemTemplate> 

<b><%# Container.Dataltem(" Title") %></b><br /> 

ISBN: <%# Container.Dataltem("ISBN") %> &nbsp; 

Published: <%# DataBinder.Eval(Container.Dataltem, "PublicationDate", "{0:D}") %> 
</ItemTemplate> 

</ASP:DataList><p /> 


<b>&lt;ASP:CheckBoxList&gt;</b> control:<br /> 
<ASP:CheckBoxList id="MyCheckList" runat="server" /><p /> 


<b>&lt;ASP:RadioButtonList&gt;</b> control:<br /> 
<ASP:RadioButtonList id="MyRadioList" runat="server" /><p /> 


</form> 
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<script language="vb" runat="server"> 
Sub Page_Load() 


'get connection string from web.config 
Dim strConnect As String = ConfigurationSettings.AppSettings("DsnWroxBooksOleDb") 


‘create a SQL statement to select some rows from the database 
Dim strSelect As String 
strSelect = "SELECT * FROM BookList WHERE ISBN LIKE '07645438%" 


‘create a variable to hold an instance of a DataView object 
Dim objDataView As DataView 


'get DataView from get-dataview-control.ascx user control 
objDataView = ctlDataView.GetDataView(strConnect, strSelect) 


If IsNothing(objDataView) Then Exit Sub 
'set the DataSource property of the controls 


'<select> list displays values from the Title column 
'and uses the ISBN as the <option> values 
MySelectList.DataSource = objData View 
MySelectList.DataValueField = "ISBN" 
MySelectList.DataTextField = "Title" 


'do same with ASP: list controls 
MyDropDown.DataSource = objDataView 
MyDropDown.DataValueField = "ISBN" 
MyDropDown.DataTextField = "Title" 


MyASPList.DataSource = objDataView 
MyASPList.DataValueField = "ISBN" 
MyASPList.DataTextField = "Title" 


'a DataGrid can figure out the columns in the DataView 
'by itself, so we just set the DataSource property 
MyDataGrid.DataSource = objDataView 


'the Repeater and DataList require <ItemTemplate> entries 
'that specify the columns - this 1s done within the element 
‘definition earlier in the page 

MyRepeater.DataSource = objData View 
MyDataList.DataSource = objDataView 


'in the CheckboxList we'll display the Title and 
'use the Value as the control value 
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MyCheckList.DataSource = objDataView 
MyCheckList.DataValueField = "ISBN" 
MyCheckList.DataTextField = "Title" 


'in the RadioList we'll display and format the 

'Value and use the Key as the control value 

MyRadioList.DataSource = objData View 

MyRadioList.DataValueField = "ISBN" 

MyRadioList.DataTextField = "PublicationDate" 
MyRadioList.DataTextFormatString = "Published on {0:dddd, MMMM dd, yyyy}" 


‘finally, bind all the controls on the page 
Page.DataBind() 


End Sub 


</script> 


</html> 
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مثال ربط قيمة متكررة إلى غرض ٥ل‏ 2ء8 Data‏ : 
في هذا المتال سنستعرض ربط البيانات إلى غرض 2406۲٥4۸أ4(.‏ سنتعامل مع هذا الغرض فقط كحاوية 
لمجموعة من الصفوف لأننا سنؤجل الحديث عن الاتصال مع قواعد البيانات وكيفية الحصول على البيانات 
منها إلى جلسة مخصصة لهذا الغرض . 


Repeated-Value Data Binding to a DataReader Object 


Puiblication [ale 

11/08 20ID 0:00:00 
01/a ZOD OO:DD:00 
D11 2ODO OO: :00 
11,04,2000 00:00:00 
11,ê, anû ûû :0û :0û 


11,02,2000 00:00:00. 


11/03200 00:00:00 
1O1, 200 00:00:00 
01/01/2001 00:00:0 
1/32005 0:6:66 
11/Dë,' 2000 00:00:00 
J1/UaFA0DD OO:00:00! 
D1/DEFZUDT O :00 00 
01/042001 00:00:00 
01/122000 00:00:00 
01,05,2000 10:00:00 
11,/DEF2UN1 D:D OD! 
D103, 200 30:00:00| 
01/10ranûa o0 :00:00 
û1/01,2002 0û :01:00 
11,03,2000 00:00:00 
O1F12 AOD 00:00:00 
1/7201 DO: :00 
01/10/2000 o0 :û0 :00 


<. ASP:DataGridz control: 

ISBN Title 

1861003013 Frofessiohal Linu: Programming 
IBIAS Frofessional Symbian Programming 
1851003064 Begining Yisual Basit SQL Server 7.0 
1861003129 XSLT Programmers Referarıcs 
1861013145 Baqinnirng Perl 

1861003218 Alex Homer's Professional 4P Web Tachniques 
1861003234 ASP 3.0 Programmer's Reference 
1B51003242 Professional 4DO 2,5 EDS Programming With A42P 3.0 
1861003293 Professional Blz Talk 

11003323 Professional Yleual Basic ê #ÎvÎL 
18610023412 Bagqimning XWÎL 

18610013439 Beginning XHTML 

18561003952 Professional Jinî 

i1BE1003579 Professional XSL 

1851003587 Professlonal XL Databases 

1851003625 Professional Java Sarvear Pages 
185103641 Professional Java Custom UT Components 
18610036ES Eeqimning Jãrã ê - JK 1.3 YErslon 
1861003730 Begining PHP4 

181003757 Professional Java eb Services 
1Bé61003811 Baginmning STK+YGNOME Programming 
1B51NO3EEN Professional Java Programming 
1851003897 Professional 12a Mobile Frogramming 
1861003927 Professional ASF Lala 


Eaqinning E-Commerce With Wleual Basil, 4SP, SAL Server 7.0 and 


EERE) MTS 


1/03, 2000 O0:00:00: 


<%@Page Language="VB"%> 


<%@Import Namespace="System.Data" %> 
<%@ Import Namespace="System.Data.OleDb" %> 


<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> 
<html><head> 

<title>Repeated-Value Data Binding to a DataReader Object</title> 

<style type="text/css"> 

body, td {font-family:Tahoma,Arial,sans-serif; font-size: 10pt} 

input {font-family:Tahoma,Arial,sans-serif; font-size:9pt } 

.heading {font-family:Tahoma,Arial,sans-serif; font-size:14pt; font-weight:bold } 

.subhead {font-family:Tahoma,Arial,sans-serif; font-size:12pt; font-weight:bold; padding- 
bottom:5Spx } 

.cite {font-family:Tahoma, Arial,sans-serif; font-size:Spt} 
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</style></head> 
<body bgcolor="#ffffff"> 
<span class="heading">Repeated-Value Data Binding to a DataReader Object</span><hr /> 


<div id="outError" runat="server" /> 


<!-- Unlike the DataView we can only bind a object DataReader to one control --> 
<!-- after it has bound the data the reader is at the end of the source rowset --> 
<b>&lt;ASP:DataGrid&gt;</b> control:<br /> 

<ASP:DataGrid id="MyDataGrid" runat="server" /><p /> 


<script language="vb" runat="server"> 
Sub Page_Load() 


'get connection string from web.config 
Dim strConnect As String = ConfigurationSettings.AppSettings("DsnWroxBooksOleDb") 


‘create a SQL statement to select some rows from the database 
Dim strSelect As String 
strSelect = "SELECT * FROM BookList WHERE ISBN LIKE '07645437%" 


‘create a variable to hold an instance of a DataReader object 
Dim objDataReader As OleDbDataReader 


Try 


‘create a new Connection object using the connection string 
Dim objConnect As New OleDbConnection(strConnect) 


'open the connection to the database 
objConnect.Open() 


'create a new Command using the connection object and select statement 
Dim objCommand As New OleDbCommand(strSelect, objConnect) 


'execute the SQL statement against the command to get the DataReader 
objDataReader = objCommand.ExecuteReader() 


Catch objError As Exception 

'display error details 

outError.InnerHtml = "<b>* Error while accessing data</b>.<br />" _ 
& objError.Message & "<br />" & objError.Source & "<p />" 


Exit Sub ' and stop execution 


End Try 
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'set the DataSource property of the control 

'a DataGrid can figure out the columns in the DataReader 
'by itself, so we just set the DataSource property 
MyDataGrid.DataSource = objDataReader 
MyDataGrid.DataBind() 'and bind the control 


End Sub 


</script> 


العمل مع الأنماط والقوالب 
رأينا خلال الجلسة الماضية وخلال هذه الجلسة كيف أن عملية ربط البيانات هي عملية غاية في السهولة 
ورأينا كيف توفر الجهد وتقلل الحاجة إلى كتابة نصوص برمجية طويلة. 


لن ما طرق ليه في هذا الجرء هر ية لكرج الببانات باامطين المرب ٠إ‏ يكن الرضون الى هذا 
الغرض بتلاث طرق : 
- إضافة أنماط CS8‏ إلى عنصر التحكم إما مباشرةء أو عن طريق التأشيرة <#ال8> في الصفحةء أو 
بإسناد قيمة إلى الخاصة S١‏ لعنصر التحكم. 
- إنشاء قالب يحدد طريقة الإظهار في مقاطع مختلفة من خرج عنصر التحكم. 

استخدام مزيج من الطريقتين السابقتين. 


إضافة أنماط SS‏ إلى عنصر التحكم 


يمكن التحكم بالنمط مباشرة عن طريق استخدام التأشيرة #ارأ8: 
<style type="text/css">‏ 
body, td {font-family:Tahoma,Arial,sans-serif; font-size: 10pt}‏ 
input {font-family:Tahoma,Arial,sans-serif; font-size:9pt}‏ 
</style>‏ 


في المثال السابق ستأخذ جميع العناصر التي تستخدم <ألامأ> إضافة إلى كل عناصر تحكم نماذج الوب 
بالتنسيق المحدد في أام٣|.‏ 
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استخدام الخاصة ٥ا5‏ لعناصر التحكم: 

تتوي معظم عناصر تحكم القوائم المصممة للربط مع البيانات على مجموعة من الخصائص التي يمكنها تعديل 
الأنماط المستخدمة في الصفحة. يمكن استخدام هذه الأخيرة لتغيير مظهر العناصر في الصفحة باستثناء 
عنصر التحpÛ .Aepeater‏ 


بعض الخصائص التي يمكن ضبطها تظهر في الجدول أدناه: 


الخاة الضف 
BackColor, BackImageUrl‏ تقو م بضبط مظهر الخلفية لعنصر التحكم 


e BorderStyle, BorderColor, BorderWidth‏ ي 
تقوم بضبط إطار عنصر التحكم 


GridLines, CellPadding, CellSpacing 


1 چ 1 ل هي ر‎ Font-Name, Font-Size, Font-Bold 
تحدد نمط الاجزاء المختلفة من خر ج‎ HeaderStyle, ItemStyle, FooterStyle 
AlternatingItemStyle 


e E le NE GCE ES 
ورأينا كيف توفر الجهد وتقلل الحاجة إلى كتابة نصوص برمجية طويلة.‎ 


گنما ری هه فى 5ا لر خر فة كراج الانات تاشر المرب .ا يكن الرضرن ى ها 
الغرض بتلاث طرق : 

- إضافة أنماط CS8‏ إلى عنصر التحكم إما مباشرةء أو عن طريق التأشيرة <#ال8> في الصفحةء أو 
بإسناد قيمة إلى الخاصة S٠‏ لعنصر التحكم. 

- إنشاء قالب يحدد طريقة الإظهار في مقاطع مختلفة من خرج عنصر التحكم. 

استخام مزيج من الطريفتين السابقتين. 


إضافة أنماط ٥SS‏ إلى عنصر التحكم 
يمكن التحكم بالنمط مباشرة عن طريق استخدام التأشيرة #ارأك. 
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استخدام الخاصة S٥‏ لعناصر التحكم: 

تتوي معظم عناصر تحكم القوائم المصممة للربط مع البيانات على مجموعة من الخصائص التي يمكنها تعديل 
الأنماط المستخدمة في الصفحة. يمكن استخدام هذه الأخيرة لتغيير مظهر العناصر في الصفحة باستثناء 
عنصر lتحpÛ .Aepeaier‏ 


العمل مع الأنماط والقوالب 


مثال على استخدام 055 للتحكم بطريقة إظهار الخرج لعناصر التحكم: 
الشكل التالي هو الخرج للنص البرمجي أدناه: 


: Î ı ê 
1Û: 
1 Ûr ê 
10c 
RO: | 
Orê | 
1 FO: gQ 


+00: 900 
: 00:00 
; DO: 
:DO: OF 
HEDÎ 
O: Û | 
:DO:ê0 
3 RÛ: 


النص البرمجي: 


Fubiieatian bate 
ûi/ûü27êû0û ûû 
i132 00ê ûû 
i1/01/2ûûê ûû 
1/10/2000 00 
01/03/2000 ûû 
O1/lérêlêd ûû 


017122001 00 


0170772000 00 
01/08/2001 00 
F122 001 00 
010972001 00 
171172001 00 
Nif02/20tz 0û 
F1F11/2001 00 
1,022 0êz ûû 


Using CSS to Add Style to a DataGrid 


LE Titla 

iIBéiĞû32iš Alex Homer's Frafessianol AŠF eb Taehniqiaes 

1B#1003234 AĞF 3-0 frogramer"s Raferanêu 

IBS1003I24S Profesional AO ã2, RDŠ raga mmiig Wwirh AĞF 3.0 

1RE10039ET Frofarlomol ASF ata 

18610039 ډ‎ Baginning Er Cammeree With Vizuol Baie ASF SOL Samur 7. And MTS 

1851004023 Frofezlafêl AŠF AL 

18e1004397 Fratearlonal C# Web Seruices: Euilding HET Web Servier wiih AĞF. HET snd HET 
Be motirg 

IBEIFHTSE A PFreviee of A5Fa 

1841005040 Begirmrig ASF HET 

IHBIDISZ29 Begining ASF HET Mabile Contrels 

IBIN ASF NET Programmer's Eefarurmoe 

1881005452 Frofessiomol ASF HET eb Services 

1881705844 Frofessiomol ASF HET Server Controls 

IBB1ME15Z Begmning ASF HET using CE 

1B88130TOAS Frofessiomol A5F HET And Edîn 
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input {font-family:Tahoma,Arial,sans-serif; font-size:9pt} 

.heading {font-family:Tahoma,Arial,sans-serif; font-size:14pt; font-weight:bold } 
.subhead {font-family:Tahoma, Arial,sans-serif; font-size:12pt; font-weight:bold; padding- 
bottom:Spx } 

.cite {font-family:Tahoma,Arial,sans-serif; font-size:Spt } 

</style></head> 

<body bgcolor="#ffffff"> 

<span class="heading">Using CSS to Add Style to a DataGrid</span><hr /> 


<div id="outError" runat="server" /> 


<ASP:DataGrid id="MyDataGrid" runat="server" 
ShowHeader = "True" 

ShowFooter = "False" 

BackColor = "darkgray" 

BackImageUrl = "background.gif" 

ToolTip = "A List of Wrox Books" 

GridLines = "None" 

BorderStyle = "Solid" 

BorderColor = "black" 

BorderWidth = "3" 

CellPadding = "2" 

CellSpacing = "2" 

Font-Name = "Comic Sans MS" 

Font-Size = "10pt" 

Font-Bold = "True" > 

<HeaderStyle ForeColor = "blue" /> 
<ItemStyle ForeColor = "red" /> 
<AlternatingItemStyle ForeColor = "green" /> 
</ASP:DataGrid> 


<script language="vb" runat="server"> 
Sub Page_Load() 


'get connection string from web.config 
Dim strConnect As String = ConfigurationSettings.AppSettings("DsnWroxBooksOleDb") 


'create a SQL statement to select some rows from the database 
Dim strSelect As String 
strSelect = "SELECT * FROM BookList WHERE Title LIKE '%ASP%"" 


‘create a variable to hold an instance of a DataReader object 
Dim objDataReader As OleDbDataReader 


Try 


‘create a new Connection object using the connection string 
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Dim objConnect As New OleDbConnection(strConnect) 


'open the connection to the database 
objConnect.Open() 


‘create a new Command using the connection object and select statement 
Dim objCommand As New OleDbCommand(strSelect, objConnect) 


'execute the SQL statement against the command to get the DataReader 
objDataReader = objCommand.ExecuteReader() 


Catch objError As Exception 

'display error details 

outError.InnerHtml = "<b>* Error while accessing data</b>.<br />" _ 
& objError.Message & "<br />" & objError.Source & "<p />" 

Exit Sub ' and stop execution 


End Try 


'set the DataSource property of the DataGrid 
MyDataGrid.DataSource = objDataReader 


'and bind the control to the data 
MyDataGrid.DataBind() 


End Sub 


</script> 


استخدام القوالب مع عناصر التحكم المرتبطة 


لخن الط رف الاه لتك :افير الخاص ارج امار تك اقرا فياضا فرت الى ترف 
يمكن للقوالب أن تقوم بتحديد الأعمدة التي سيتم إظهارها وكيف سيتم إظهار القيم. 


تقبل ثلاثة من عناصر التحكم استخدام القوالب وهي العناصر DataGrid«DataList«Repeaer:‏ 
يمكن أن نستخدم مع هذه العناصر مجموعة من القوالب التي تحدد طريقة الإظهار والمحتوى الخاص بكل 
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فيمايلي رمم يبين المجموغة المتأحة من القوالب: 


HeaderTemplatê 

tte Template 
Alternatingltem Template 
SelectedltemTemplate 


SeparatorTemplatê 


Editltem Template 


FooterTemplate 


تفسر أسماء القوالب نفسها ولكن يبقى القالب تفير SelectedItem Template‏ 

والقالب 6أ2ام ۳۲٥۴۳"‏ اا۵ حيث يحدد الأول طريقة إظهار العناصر التي يجري اختيارها. 

أما الثاني فهو مخصص لتحديد طريقة إظهار العناصر التي يجري تحرير قيمها. 

تتلاخص الطريقة الثانية للتحكم بالمظهر الخاص لخرج عناصر تحكم القوائم في إضافة قوالب إلى تعريف 
عنصر التحكم. 

يمكن للقوالب أن تقوم بتحديد الأعمدة التي سيتم إظهارها وكيف سيتم إظهار القيم. 


تقبل ثلاثة من عناصر التحكم استخدام القوالب وهي العناصر DataGrid«DataList«Repeaer:‏ 
يمكن أن نستخدم مع هذه العناصر مجموعة من القوالب التي تحدد طريقة الإظهار والمحتوى الخاص بكل 


جزء من الخرج. 
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مٿال عن استخدام قالب بسيط مع عنصر تحکم :Repea)er‏ 


Using a Simple Template with a Repeater Control 


Some of the Latest Wrox Press Books 


Frofassional Application Cantar 2000 

ISEN!: IBÖIOO44TBE Published: 01403200 

This book tokeês you through the camplêtê process of setting Up and creating Web 
clusters and component clusters, adapting your applications to wûrk in a clustered 
scenarin, and how you can administer and monitor them, 


A Freview of A5P+ 

TISEN: 1Bé1004753 Published: Ql#0772000 

Active Šerver Pages (A5PNET} makes if easier, foster and less error-prone to 
writs your own Wak applications and dynamic Web pages, In a lot of cases, there 
is acTUally lêss cadê fo wrifê - anû somêètimê nofê af all. 


Professional ASF XML Programming 

ISEN: I[BéIOO4QEE Published: OB 2D00 

As ASP is probably the best server-side coding platform far Windows-based 
systems, I'3 an obvious choice for uzê with AML, This book looks at all of thê #ML- 
related issues you will face when working in this environment, 


Beginning Components for ASP 

ISEN: IBéIQOZBAZ Published: O1#03/2000 

If ¥ou use AĞP, you're only qefting half the power of this exciting programming 
environment if you don't build and use components. This book shows you how fo qet 
started, with plenty of tips, tricks and useful information. 


النص البرمجي: 
<%@Page Language="VB"%>‏ 


<%@Import Namespace="System.Data" %> 


<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> 
<html><head> 

<title>Using a Simple Template with a Repeater Control</title> 

<style type="text/css"> 

body, td {font-family:Tahoma,Arial,sans-serif; font-size: 10pt} 

input {font-family:Tahoma,Arial,sans-serif; font-size:9pt} 

.heading {font-family:Tahoma,Arial,sans-serif; font-size:14pt; font-weight:bold } 

.subhead {font-family:Tahoma,Arial,sans-serif; font-size:12pt; font-weight:bold; padding- 
bottom:Spx } 

.cite {font-family:Tahoma,Arial,sans-serif; font-size:Spt} 
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.rHead {font-family:Lucida Handwriting,Comic Sans MS, Tahoma,Arial; 
font-size:14pt; font-weight:bold; padding:8px; color:green } 

.rItem {font-family:Lucida Handwriting, Comic Sans MS,Tahoma,Arial,sans-serif; 
font-size: 10pt} 

.TFoot {font-family:Tahoma,Arial; font-size:Spt; padding:Spx; color:darkgray } 


</style></head> 
<body bgcolor="#ffffff"> 
<span class="heading">Using a Simple Template with a Repeater Control</span><hr /> 


<ASP:Repeater id=" MyRepeater" runat="server"> 


<HeaderTemplate> 

<div class="rHead'"> 

Some of the Latest Wrox Books from Wiley<br /> 
<img src="images/redrule.gif"> 

</div> 

</HeaderTemplate> 


<ItemTemplate> 

<div class="rItem"> 

<img src="images/<%# Container.Dataltem("ImageURL") %>" 
align="left" hspace="10" /> 

<b><%# Container.Dataltem(" Title") %></b><br /> 
ISBN: <%# Container.Dataltem("ISBN") %> &nbsp; 
Published: <%# DataBinder.Eval(Container.Dataltem, _ 
"PublicationDate", "{0:d}") %><br /> 

<%# Container.Dataltem("Precis") %o> 

</div><br clear="all" /> 

</ItemTemplate> 


<SeparatorTemplate> 
<img src="images/redrule.gif"> 
</SeparatorTemplate> 


<FooterTemplate> 

<img src="images/redrule.gif"> 

<div class="rFoot"> 

For more information visit <a href="http://www.wrox.com">http://www.wrox.com</a> 
</div> 

</FooterTemplate> 


</ASP:Repeater><p /> 


<script language="vb" runat="server"> 


Sub Page_Load(0 
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‘create a new empty DataTable object 
Dim objTable As New DataTable("NewTable") 


'define four columns (fields) within the table 

objTable.Columns.Add("ISBN", System.Type.GetType("System.String")) 
objTable.Columns.Add("Title", System.Type.GetType("System.String")) 
objTable.Columns.Add("PublicationDate", System.Type.GetType("System.DateTime")) 
objTable.Columns.Add("ImageURL", System. Type.GetType("System.String")) 
objTable.Columns.Add(""Precis", System. Type.GetType("System.String")) 


'declare a variable to hold a DataRow object 
Dim objDataRow As DataRow 


‘create a new DataRow object instance in this table 
objDataRow = obj Table.NewRow(0 


'and fill in the values 

objDataRow("ISBN") = "0764544020" 

objDataRow(" Title") = "Beginning Access 2002 VBA" 
objDataRow("PublicationDate") = "February 2003" 

objDataRow("ImageURL") = "4020.gif" 

objDataRow( Precis") = "Access 2002 is the core database application within " _ 
& "the Office XP suite. This book focuses on the programming language that " _ 
& "underlies Access 2002 and all the other office products." 
objTable.Rows.Add(objDataRow) 


objDataRow = obj Table.NewRow(O 

objDataRow("ISBN") = "0764543636" 

objDataRow( Title") = "Beginning Active Server Pages 3.0" 

objDataRow("PublicationDate") = "July 2000" 

objDataRow("ImageURL") = "3636.gif" 

objDataRow("Precis") = "This book is for beginners who have no previous experience " _ 

& "of ASP, C#, XML, object-oriented programming, or the .NET Framework. A little " _ 

& "knowledge of HTML is useful, but by no means essential as all the concepts that " _ 

& "you need in order to create dynamic ASP.NET web sites are presented and explained in full." 
objTable.Rows.Add(objDataRow) 


objDataRow = obj Table.NewRow() 

objDataRow("ISBN") = "0764543695" 

objDataRow("Title") = "Beginning ASP.NET 1.0 with Visual Basic.NET" 
objDataRow("PublicationDate") = "February 2003" 

objDataRow("ImageURL") = "3695.gif" 

objDataRow("Precis") = "This book is for beginners who have no previous experience of " _ 

& "ASP, VB, XML, object-oriented programming, or the .NET Framework. All the concepts " _ 
& "you need in order to create dynamic ASP.NET web sites are presented and explained in full." 
objTable.Rows.Add(objDataRow) 


objDataRow = obj Table.NewRow(O0 
objDataRow("ISBN") = "0764543962" 
objDataRow(" Title") = "Professional ASP.NET 1.0, Special Edition" 
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objDataRow("PublicationDate") = "February 2002" 

objDataRow("ImageURL") = "3962.gif" 

objDataRow("Precis") = "This book is for people that have a solid understanding of ASP " _ 

& "and are familiar with VB or C-based syntax. It will show you how to develop sophisticated " _ 

& "ASP.NET applications using the .NET Framework with its comprehensive and in-depth guide " _ 
& "to this exciting new technology." 

objTable.Rows.Add(objDataRow) 


'assign the DataTable's DefaultView object to the Repeater control 
MyRepeater.DataSource = objTable.Default View 
MyRepeater.DataBind() 'and bind (display) the data 

End Sub 


</script> 
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الفصل التاسع والعاشر 


عنوان الموضوع: 
إدراة الحالة وأحداث تطبيقات الوب 


الكلمات المفتاحية: 


ملخض : 


يعتبر حفظ وإدارة معلومات الحالة عملية أساسية في بيئة الوب. سنتعرف في هذه الجلسة على الآلية التي تتعامل بها 


SP. N٤1‏ مع الحالة كما سنتعرف على الأحداث الخاصة بتطبيقات الوب. 


أهداف تعليمية: 

يتعرف الطالب في هذا الفصل على: 
٠ه‏ مفهوم إدارة الحالة 

ASP.N۴۲ أغراض الحالة في‎ ٠ 
۸8۲.۸۴۲ أحداث التطبيق في‎ ٠ه‎ 
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إدارة الحالة في تطبيقات ۸8۲.٤7‏ 


ف إدارة الحالة بأنها المحافظة على قيم أو أغراض خلال حياة تطبيق الوب أو خلال مرحلة تفاعل 


توفر ۸5۴.N٤٣‏ أربعة وسائل للتوصول إلى هذا الغرض . 
- حالة المستخدم (Session(‏ 

- حالة التطبيق )ہApplicati0(‏ 

- الحالة المرحلية للتطبيق (عطءa٣)‏ 

الت لت اسا 


تعرّف إدارة الحالة بأنها المحافظة على قيم أو أغراض خلال حياة تطبيق الوب أو خلال مرحلة تفاعل 
المستخدمين مع التطبيق. 

توفر ۸5۴.٤٣‏ أربعة وسائل للتوصول إلى هذا الغرض . 

- حالة المستخدم («10ءءع؟): يتم التحكم والإبقاء على حالة المستخدم باستخدام الغرض ١0٥1ءءم؟‏ الذي 
يسمح بالإبقاء على بيانات لمدة محدودة من الزمن (عادة ما تكون 20 دقيقة) لمستخدم محدد. تكون بيانات 
غرض وم5 الخاصة بمستخدم معزولة تماما عن بيانات هذا الغرض بالتسبة لمستخدم آخر: 

على سبيل المثال يمكننا استخدام الغرض ١10وءم؟‏ إذا أردنا تتبع اليافطات الإعلانية التي قمنا بإظهارها 
لمستخدم معين. فإذا لم يقم المستخدم بالتفاعل مع الموقع خلال الزمن المعين» ستنتهي صلاحية البيانات وسيتم 
حذفها لهذا المستخدم. 

- حالة التطبيق (١٥1دءنامم4):يتم‏ التحكم بحالة التطبيق والإبقاء عليها من خلال الغرض 

1۳0 مم الذي يسمح بالحفاظ على البيانات الخاصة بتطبيق معين. تكون هذه البيانات متاحة لجميع 
المصادر(صفحات وب › خدمات وب ...). 

- الحالة المرحلية للتطبيق (ع1ء4٤):‏ يتم التحكم بالحالة المرحلية باستخدام الغرض ١1ءه٤.‏ يكون عمل 
الغرض 1ء٥‏ مشابه للغرض ١٥1اةءامم4‏ في كونه مشترك أي يمكن الوصول إليه من أي مصدر 
ضمن تطبيق الوب. إلا أن لهذا الغرض مزايا إضافية. فعلى سبيل المثال» قد يلزمنا أن نقوم بتأهيل غرض 
مستخدم من جمیع صفحات ۸58P. ٤1‏ من ملف ]۷× عند بدء تشغیل تطبیق الوب“ عندھا نستطیع أن 
نخزن هذا الغرض ضمن الغرض ٥٥16‏ وننشاً مؤشرا لهذا الغرض على ملف ۷1× مصدر البيانات. في 
حال تغير ملف البيانات ستتحسس ۸8۴.1٥‏ ذلك وستقوم بإلغاء صلاحية العنصر الذي تمت عليه التغييرات. 
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- المتحولات الساكنة: بالإضافة إلى استخدام الغرض ١٥1اهء1ام‌م۸‏ و ٥٥18‏ یمکننا استخدام أحد 
التسهيلات التي تقدمها البيئة غرضية التوجه في ۸5۶.٤"‏ وهي المتحولات الساكنة. حيث يمكننا التصريح 
عن متغيرات ساكنة وعندها سيتم إنشاء نسخة وحيدة من هذه المتغيرات مهما كان عدد نسخ الصف الذي 


جری إنشاؤه. 
يمكن الوصول إلى هذه المتغيرات عبر التطبيق وفي بعض الحالات تكون أكثر فائدة من الغرض 
.Application‏ 


استخدام أغراض الحالة 
یکون استخدام الغرض 410۸ءنامم۸ والغرض 10۸وءم؟ في ۸8۲.٤1‏ مطابقاً لاستخدامهما في ۸8۲۴. 
إذ يكفي إسناد قيمة وتحديد سلسة محارف كمفتاح للعنصر أي من الشكل. 


' Set an Application value 
Application ("SomeValue") = "my value" 
' Read an Application value 

Dim SOME SEE IRS AS SEE AMS 

SOME SIE E LINC = Aol LEAN E LOM (SOME Va LUE # ) 


' Set a Cache value 

Cache ("SomeValue") = "my value" 
' Read a Cache value 

Dim SOME SEEN AS SEE UMS 
someString = Cache ("SomeValue”™ ) 


' Set a Session Cache value 
SessionCache ("SomeVvalue") = "my value" 
' Read a session value 

Dim SOmMeSEE IRS AS SEE IRS 

SOMES LAG = SESSLON (USOMeE Va LEW ) 


سنتعرف في الشرائح القادمة على كل غرض من أغراض الحالة بالتقفصيل. 


یکون استخدام الغرض 410۸0ءنامم۸ والغرض 10۸وءم؟ في ۸8۲.٤1‏ مطابقاً لاستخدامهما في ۸8۶۴. 
إذ يكفي إسناد قيمة وتحديد سلسة محارف كمفتاح للعنصر أي من الشكل. 
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سنتعرف في الشرائح القادمة على كل غرض من أغراض الحالة بالتفصيل. 


استخدام أغراض الحالة- الغرض ١0٠ذءوم؟‏ 


تعتبر نسخة الغرض S0١‏ في ٤48۴ء‏ نسخة محسنة عن سابقتها في 48۶. فقد حلت النسخة 
المعدلة من الغرض ١٥1ء١٥5‏ مجموعة من المشاكل التي عانت منها النسخة القديمة وهي: 

٠‏ دعمها لما يى ب (مجموعة من مخدمات الوب - "۲۳ه) وهي عبارة عن وجود أكثر من مخدم وب 
حيث يمكن أن يجري تحويل الطلب لمخدم وب مختلف في كل مرة. كانت هذه العملية في النسخة القديمة 
تسبب في بعض الأحيان خللاً بسبب كون معلومات الجلسة مخزنة محلياً على المخدم . 

أما في النسخة الجديدة فيمكن أن يتم إعداد المخدمات للتشارك بمخزن وحيد لمعلومات الأغراض ١10كءءم؟.‏ 
وفي هذه الحالة لا يهم تحويل طلب المستخدم إلى مخدم آخر إذا كان هذا المخدم يستطيع الوصول إلى 
معلومات الجلسة. 

دعم استخدام الغرض ١٥ءوهS‏ حتى دون تفعيل أو دعم الكعكات من قبل المستعرض. 


البرمجة باستخدام الغرض ١10ءوم؟‏ : 


يكون الغرض Sesion‏ مخصصاً لتخزین البیانات کل مستخدم ضمن تطبیق ۴.٤1‏ ۸5. یتم التعامل مع 
الغرض ١0٥1ءءع5‏ كالغرض مء1ط12١ءه1»‏ ويجري تخزين البيانات على قاعدة قيمة/مفتاح. 


إسناد وقراءة قيمة من غرض ١0اءءم؟S:‏ 


يمكن إسناد قيمة أو غرض إلى غرض ١٥اءوم؟‏ باستخدام التعبير التالي في ۷8.٤٣‏ : 
SSSI (7 SEEING KEW | <J SOS JECE‏ 


SESSION | PISCE Kewl 4 [OEE 


على سبيل المثال» إذا أردنا استعادة القيمة الممثلة بسلسة محارف ”0۲10س 11110“ المخزنة في غرض 
sion‏ باستخدام المفتاح ”10ءsع5ءامصS1m“»‏ يكفي كتابة: 


Dim sessionValue As String 
sessionValue = Session ("SimpleSession™) 
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و في :٣#‏ 


String SessilionValue; 
sessionValue = Session ["SimpleSession"]; 


أما بالنسبة للأنماط المختلفة عن سلاسل المحارف والأغراض فسنحتاج إلى تحويل القيمة حسب النمط 
المطلوب. فعلى سبيل المثال» إذا أردنا استعادة صف مخصص قمنا بإنشاءه وتخزينه ضمن غرض الجلسة 
ولیکن الغرض ۲عل0۲ع2طrcں۴›‏ نکتب : 


Dim po As PurchaseOrder 
OO = CIVIC (SESSION (IDO), PUEECNASEOECEE ) 


PurchaseOrder po; 
OO = (PUCEMASEOECEE ) SESSLOM YOO f 


نلاحظ أننا قمنا بعملية تحويل قسري إلى النمط المحدد بالصف ۃPurchaseO]de.‏ 
بعض خصائص الغرض 4101عS‏ 
٠‏ يقدم الغرض ١10ءءع5‏ مجمو عة من الخصائص لتحديد الطريقة التي يعمل بها هذا الغرض: 


٠‏ الخاصة sءع1‌i)مه)‏ 1 تعيد القيمة ۲۲٠۵‏ أو عءاه؟ لتحدید کون غرض 0۸٥10ء6‏ يعمل باستخدام 
الكعكات أو بدون استخدامها . 
تكون الوضعية التلقائية للعمل هي ءء۴41 بمعنى أن العمل يتم باستخدام الكعكات. 


الخاصة yآر210ء‏ 3۸[ تعيد إحدى القيم True‏ أو 6 وتحدد کون غرض 5810٩‏ يعمل في 

وضعية القراءة فقط. هذه الوضعية مفيدة في الحالات التي لا نريد أن نسمح فيها بتغيير القيم المخزنة في 
الغرض 101ءءع8. 

تكون القيمة التلقائية لهذه الخاصة هي ءء۴41 أي أنها تسمح بالقراءة والتعديل على البيانات المحتواة في 


الغرض 101ءءع98. 


٠‏ الخاصة عله والتي تحدد نمط تخزين معلومات الغرض ١0٥10ءءع5.‏ هناك مجموعة من الاحتمالات 


للقيم الممكنة تتضمن «SqIserVer‏ و «stateServer‏ و «off‏ و .inproc‏ 
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إدارة حالة التطبيق باستخدام الغرض ١٥icat1١اApp‏ 


بعكس الغرض ١10ء١٥5‏ المخصص لتخزين معلومات عن كل مستخدم على حدة» يشكل الغرض 
Appi cation‏ مكان تخزين لمعلومات مشتركة للتطبيق. 
يكون هذا المخزن المشترك مفيد جد خصوصا في حالة الرغبة بإنشاء مصادرمشتركة بين كل المستخدمين . 


یستخدم غرض ١٥1هام‏ م۸ الغرض ط1۵ ءھ1 کالية تطبیق إذا یخزن البیانات على شکل تنائيات 
مفتاحاقيمة. 


لايدعم الغرض ١٠٥1ء‏ امم۸ مفهوم تخزين البيانات بصورة منفصلة عن إجراء ۸8۴.٤1‏ بل یتم تخزين 
البيانات ضمن الإجراءء فإذا تمت عملية إعادة استخدام هذا الإجراء مرة أخرى أو إعادة إقلاعه ستزول جميع 
البيانات المخزنة فيه. 


تكون المقايضة هنا على حساب الكسب في السرعة»ء فقد خسرنا الاستقلالية ولكننا حصلنا على سرعة أكبرء 
لأن استرجاع المعلومات باستخدام نفس الإجراء أسرع من استدعاء إجراء آخر لإتمام عملية الاسترجاع. 


اسناد القيم واسترجاعها من الغرض ١٥)ھc!امم۸:‏ 

تكون الصيغة المستخدمة للوصول إلى القيم باستعمال الغرض ١٥4)1ء1امم4‏ مشابهة لتلك المستخدمة مع 
الغرض ١10ء50‏ باستثناء وحيد: 

٠‏ باعتبار أنه يمكن الوصول إلى الغرض ١٥10اةءنام‏ م۸ من بيئة متعددة المستخدمين لا بد من ضمان 
تزامن التحديثات على هذا الغرض. هذا يعني أنه لا بد -وفي كل مرة نقوم فيها بتغيير البيانات- من منع 
الوصول إليها لأي مستخدم أو تطبيق آخر لحين إنهاء عملية التحديث. لحسن الحظ يوفر الغرض 
امم آلية لتمكين هذا العمل وذلك باستخدام طرق إقفال للبيانات. 
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قراءة وكتابة بيانات الغرض ١٥ن٤icaاممAp‏ 
يمكننا قراءة بيانات الغرض ١٥1اهءنامم4‏ من خلال استخدام صيغة مشابهة لما يلي: 


:VB.NET في‎ 
AOL LCA AOA (HIL COUNE ELE 4) =1 


وباستخدام ٥#‏ من الشكل: 


AOL LEE LOR [FEL ECOUNEEE 4 =O, 


وبشكل مشابه إذا أردنا قراءة القيم المخزنة في غرض ١٥هام‏ م۸ يكفي أن نستخدم صيغة من الشكل: 


:VB.NET في‎ 


WIM MLECOUAE AS LALCECGELE 
MIL ECOUNE = NOOO LEASE LOR (ZEN E COLNE GE) 


:٣# في‎ 
LAE MAL ECOUOE= MOL LEAN LOR | ZE COLIAE ENÊ J f 


أما بالنسبة لطرق الإقفال المطبقة فلا بد أن نقوم بمنع المستخدمين والتطبيقات الأخرى من إجراء أي عملية 
تحديث أو تحرير للبيانات لحين تحرير هذا الغرض من قبل المستخدم أو التطبيق الحالي. 


إذا كانت البيانات المشاركة تتغير بتكرار عالي يكون استخدام الغرض ١٥1اةءامم۸‏ لحفظ الحالة على 
قراءة وكتابة بيانات الغرض ١٥ن٤11c4اpممAp‏ 
لنلاحظ المثال التالي الذي يبين طريقة استخدام الأقفال على الغرض ١۸٥1اھء1اممA:‏ 
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:VB.NET في‎ 


ulol 1e SUS ASL LCE 1 OM OAS ELE E () 

ADEN EaAE TOR (HI ECOUNE) 0O 

End Sub 

Public Sub Application_OnBeginRequest () 
ANO 1 CEE LOA. uOCKk (0) 


MOO LEE LOR (TEL ECOUAEOET) = AogLicat ion (TELECOoUAteE®) + 1 
AOL LCA OIA ¢ UA LOCK () 
NEA SUS 


: €# وفي‎ 
OUOLLE WOLCE ALLELE 1O OMSEEEE() 
NOON LCAE AOR [YE1 TCCOUNLEEE I = OF 
} 
public void Application_OnBeginRequest () { 
ADDLILCGELORN.LOCE OT, 
int tLmMOINE = (INLJAGGLICATCLONITAITCGUNtEE TI} 
AOL LEE LOM [HL ECOUANEEET] = COANE F LF 
AO 1 CAE 1 OA . UMLOENL (J 
} 


قمنا في النص البرمجي السابق باستدعاء الطريقة 0))ء 0[ الخاصة بالغرض ١٥1اهءام‏ م۸ لضمان عدم 
محاولة أي إجراء آخر تحديث بيانات 6۲†» 11۲٣٥‏ في نفس الوقت. 

عند إيقاف الإجراء ۸5۲.٤٣‏ أو إعادة استخدامه ستزول جميع البيانات كما ذكرنا. حيث يجري إطلاق 
حدث 14٤م‏ 0_«ەi0اةءiاممA‏ عند إيقاف التطبيق أو إعادة استخدامه. يمكن استخدام معالج هذا الحدث في 
حال الرغبة بإجراء عملية حفظ للبيانات ضمن ملف أوضمن قاعدة بيانات. 


في حال عدم استدعاء الطريقة ASP.NET مgaتw Unlock‏ تلقائياً بتحریر الغرض ١1c210امم۸‏ عند 
الانتهاء من تلبية الطلب» أو انتهاء الزمن المخصص لتلبية الطلب» أو في حال ظهور خطأ ما. 


إدارة الحالة المرحلية - الغرض ءطءو٣C‏ 


يستخدم العديد من المطورين التطبيق كمخزن لحالة الموارد المستخدمة بكثرة. كما هي الحال في قراءة ملف 
1× يحتوي دليل منتجات. إذ يجري عندها تخزين الغرض الممثل لملف ۷× هذا ضمن ذاكرة التطبيق. 


ما الذي يحصل في حال تغير ملف 1× الممثل لدليل المنتجات؟ 
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في معظم الحالات يستخدم المطورون الغرض ١٥1اهءنام‏ م لتدارك التغيير بإعادة تشغيل التطبيق فيجري 
تحديث المعلومات. 

يكمن الهدف من وراء تصميم الغرض ١1ء٥‏ في منح المطورين مز ايا الغرض ١٥1٥1cامم۸‏ إضافة إلى 
مزايا أخرى مثل استبعاد عنصر من الغرض ١1ءهء‏ عندما يتم تغييره حيث تصبح مسؤولية المطور إضافة 
العنصر من جديد إلى الغرض ١1ء4‏ باستخدام النص البرمجي . 


يشبه الغرض عطءه٤‏ الصف ءطعءه الموجود ضمن فضاء الأسماء eطء2٣.طءW Systm.‏ إضافة إلى 
كونه يعمل كغرض ء1طا112ءه1 على قاعدة قيمةامفتاح كحال الأغر|اض .Session ş Application‏ 


يدعم الغرض عطءهع المزايا التالية: 

- انتهاء الصلاحية للبيانات بناء على اعتمادها على أغراض أخرى يمكن أن تكون مفاتيح غرض عطعه٣‏ 
أخرى ءملفات » التاريخ والوقت . عند أي تغيير على أي من البيانات أو الأغراض التي يعتمد عليها الغرض 
ماع يتم اعتبار البيانات غير صالحة وتتم إزالتها من بيانات الغرض عطعه٣.‏ 

- إدارة الأقفال: تتم هذه العملية بشكل مشابه للذي يتم في حالة الغرض ١٥1هام‏ مه. فبعكس الغرض 
icationاApp»‏ يمتلك الصف ١1ء٥‏ إدارة أقفال داخلية» مما لا يجعلنا مضطرين قسر ا لاستخدام L0ck)(‏ 
و 0٥10ل‏ عند التعديل على بيانات الغرض 1ء٥‏ مع الأخذ بعين الاعتبار أننا ما نزال نحتاج إلى إدارة 
العمل المتزامن للأغراض المخزنة في الغرض عطءه٤‏ كما فعلنا مع الغرض ١٥t1ھc:اApp.‏ 

- إدارة المصادر : عندما يكتشف الغرض 1ء2٥٤‏ ضغط على الذاكرة يقوم بالمرور على بياناته ويبعد 
الخاصر الأقل أستخذاما. لذا وقيل طلب أي عنصر يتوجب علينا التحقق من وجوده أولا 

- الاستدعاء الراجع: يوفر الغرض عطءه) إمكانية السماح بتشغيل نص برمجي عند إزالة عنصر من 
ا الفركن. 


إدراج العناصر في الغرض عءاءو٣€‏ 
يدعم الغرض عءطء4٥‏ طريقتين لإدراج العناصر: 


الطريقة الضمنية: هذه الطريقة مألوفة بالنسبة لنا كونها نفسها المستخدمة مع الأغراض ١10ءوه؟‏ و 
امم باستخدام الأزواج مفتاحاقيمة وتكون الصيغة من الشكل: 


:VB.NET في‎ 
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Dim productDataSet As New DataSet () 
' Populate Ualtaselr 
Cache ("products") = productDataSet 


:٣# في‎ 


DataSet productDataSet = new DataSet () ; 
1/1 Poo UlGEEe Dalal E 
Cache ["products"] = productDataSet; 


الطريقة الصريحة : باستخدام الطريقة ۲۲0ءء1[. تسمح هذه الطريقة بتحديد علاقات خاصة كعلاقات الاعتماد 


كما فى الصيغة: 
في :VB.NET‏ 
Dim productDataSet As New DataSet ()‏ 
Populate Dataset‏ ' 
Cache. INSEE (FDEOCUCEST, BEOCUUCEDALCaASELE, NoOEhING)‏ 
في :٣#‏ 


DataSet productDataSet = new DataSet () ; 
// Populate DataSet 
CaeRme . IRSERBE ( LSE OGAUCE SL, OEOMUECE DAE ASCE, MULL) 


عند استخدام الغرض 18ء4٥‏ سنستخدم على الأغلب الطريقة الصريحة باستعمال )1"۶۵۲۲. 


إنتهاء الصلاحية المبني على الاعتمادية 


يعد انتهاء الصلاحية المبني على الاعتمادية آلية في غاية القوة إذ أنه يمكننا من إنشاء علاقة بين عنصر من 
الغرض عءطعءهة٣‏ وملف» لفترة محددة من الزمن. متال: 


<%5@ Import Namespace="System.Xml" %> 

<%5@ Import Namespace="System.Xml.Xsl" %> 

<Script runat="server"> 

Public Sub Page_Load(sender As Object, e As EventArgs) 

Dim dom As XmlDocument 

DIM s<eE lL AS NEW KS ME ENNS 1 OIE ( 

' Do we have the WEOX Pro ASP.NET 21d Ed book in the Cache? 
8 sNothing (Cache ("1861007035.xm1l") )) Then 
CacheStatus. Text = "Item not present, updating the Cache..." 
UpOAAEECaCHE(TI186100 7035. MmL") 


اص 
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Else 

CacheStatuUs.Texlt = "Retrieving from Cache" 

MEL LIE 

U oad EME EGA S E OEM 

xSsl.Load (Server.MapPath ("book.xsl") ) 

dom = CType (Cache ("1861007035.xml"), XmlDocument ) 


BookDisplay.Document = dom 
BookDI1Splay.Iransflorm = Sl 
eel Sle) 


Public Sub UpdateCache (strltem As String) 

DIM SEEEAEN AS SERR 

Dim dom As New XmlDocument () 

' Determine the file path of the file to monitor 
strPath = Server.MapPath (strItem) 

' Load the file into an Xml DOM 

UOM. LGA SETAE) 

' Create a CacheDependency on the file 

Dim dependency as New CacheDependency (strPath) 

' Cache Ehê XML GocUmenE 

Cache. Insert (strItem, dom, dependency) 

3l SUS 

GJ OEE LOLS 

SEAEUSS ASO: LaOelL 1= CacMEeSEAEUSY EUNAC=SEE VO / 3 
BEZ 

ASD ML LE NBEOOKDLEOLEYY EUNAC=SEE VOL / 3 


تظهر في المثال السابق التعليمات المتعلقة بالغرض C٥1١‏ بلون مغايرء سنهمل الآن التعليمات الأخرى 
المتعلقة ب ۷× كوننا سنفرد جلسة خاصة لهذا الموضوع» فما يهمنا الآن هو ملاحظة كيف يتم التأكد من 
وجود العنصر ضمن الغرض ١1ء4١‏ و كيف يتم استخدامه بعد تحويله إلى صيغة وثيقة ۷1× باستخدام 
ممyا).‏ أو كيف يمكن استخدام الإجرائية ٠1ء‏ 2٤٠2ل‏ صن لإسناد غرض وثيقة ۷1× الحامل للملف من 
جدید إلى غرض 1٥ھ‏ باستخدام التعلیمة 1,6۲۲0 بعد تحدید غرض رہ لہءم5ءطءCa‏ جدید لتأسیس 
علة بين الملف وغرض عطعه€. 


يعد انتهاء الصلاحية المني على الاعتمادية آلية في غاية القوة إذ أنه يمكن من إنشاء علاقة بين عنصر من 
وملف» لحظة محددة من الزمن ¢ أو مفتاح آخر ضمن نفس الغرض. ٥1ء0‏ الغرض 


مثال 
وضح المثال في الشريحة السابقة كيفية مر اقبة احتواء الغرض عء1ءة٣‏ على غرض ملف ا۷N>.‏ ولكن ماذا 
لو أردنا إزالة عنصر أو أكثر من الغرض ءطءه٤‏ عند تعديل عنصر آخر ضمن هذا الغرض. 
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يتم تأمين هذا الخيار عبر ما يسمى الاعتمادية على أساس المفتاح. تكون الصيغة المستخدمة لدعم هذا الخيار 


مشابهة لتلك المستخدمة عند استخدام الاعتمادية على أساس الملف. فعلى سبيل المثال نستطيع بسهولة تغيير 
النص البرمجي للمثال السابق بحيث يدعم الاعتمادية على أساس المفتاح بتعديل مجموعة من الأسطر. 


<%5@ Import Namespace="System.Xml" %> 

<Script runat="server"> 

Public Sub Create (sender As Object, e As EventArgs) 

'"' Create the Cache entry for the dependency relationship 

' the value of the key doesn't matter 

Cache ("booksDependencyKey") = "Book Dependency" 

' Create a string array with the key names for the 

' dependencies to be created upon 

Dim dependencyKey (0) As String 

dependencyKey (0) = "booksDependencyKey" 

' Create a CacheDependency on this key 

Dim dependency as New CacheDependency (nothing, dependencyKey) 

' Cache the XML document 

Cache. INSEE (TISG6I00 035 .Sml1", LOA IS6L1007035. ML"), decendency) 
cEalUS () 
End Sub 
Private Function Load{(xmlFlile As SIErIing) As XmlDocument 
Dim dom As New XmlDocument () 
dom. Load (Server.MapPath (xmlFile) ) 

Return dom 

ENO FUnNCELOoN 

Public Sub Invalidate (sender As Object, e As EventArgs) 
Cache. Remove ("booksDependencyKey™) 

cla (J 

EA@ Sub 

ULE SUS SLAMS (0) 

SNGERING{CACHELTISOLOO7 0SS. mL") J} Then 
IbISEaEUS lL. TexE — NO ale 

Else 
1bD1Statusl. Text = "Cache entry exists..." 

AES E 

EnQd SUB 

GJ OEE LOLS 

<form runat=server> 

MOE EOSce LSM EL OMISEEMC EE Ee E LCRA EE 

VALUE= HEEEAEê Cache ERMCELESY EUnRaAt = Server /3 

<input type="submit" OnServerClick="Invalidate" 

VALUE= INVA ACA KEOVY CUNIC=HEOTTUEEY 7/3 

€ OEMS 

SlLallus EOE Cache Kev: 1610070535 .SmML: <DS><a S0: label 10" IbISTaLUSI® 
UME E = SOK VOR SSO 


ص 
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عند تشغيل النص البرمجي السابق نحتاج إلى ضغط زر ache E٥۸)!‏ مatءr€‏ لإنشاء بيانات الغرض 
عمCach‏ الخاص بملف ال-]MN×‏ وبعلاقة الاعتماد. 


بعدها يمكننا نقر رع عل 1اه۷ہ!] الذي يقوم بإطلاق الحدث ءاه ل1ا۷2,١1.‏ 
نقوم ضمن هذا الحدت بإز الة المفتاح Key‏ رendencمBooksDep‏ بصورة صريحة. 
ف ا وخر فة ا ا ات لے کی عو وة اا که 


بالإضافة إلى الاعتمادية على أساس الملف والاعتمادية على أساس المفتاح يمكننا إنشاء إعتمادية على أساس 
القيمة الزمنية. 


مثال: 
إذا أردنا تخزين جميع عناوين الكتب في جدول واحد من قاعدة البيانات» وعلمنا أنه يجري تحديث هذه 
البيانات مرة في الأسبوع» يمكننا أن ندرج الغرض اءءهاه الممثل لهذه البيانات ضمن الغرض عطءة٣‏ 


بصورة صريحة مع صلاحية ننتهي بعد 60 دقيقة. 


سيوفر علينا هذا الأمر الاتصال بقاعدة البيانات عند كل طلب مع ضمان أنه حتى في حال ظهور تحديث على 
البيانات فإن البيانات التي تتم استعادتها ستكون محدثة خلال الساعة التالية. 


<%5@ Import Namespace="System.Data" %> 

eC MOORE Mame SsP alee SVS ECEM Da EA SG LCUEREL > 
<script runat=server> 

Bive Ee DSN AS SEE ARI 

Public Sub Page_Load(sender As Object, e As EventArgs) 
Dim strCacheKey As String 

Dim titlesDataSet As DataSet 


strCacheKey = "Titles" 

If (IsNothing (Cache (strCacheKey) )) Then 
LbDISLALUS. TEST = TCELTING Cala IEFOM Calaba..." 
LoadTitles (strCacheKey) 

Else 

1BDISTaltus.TeExl = "CGeLLING Gala from Cache..." 
BRS E 


titlesDataSet = CType (Cache (strCacheKey), DataSet) 
LE LELE , DECEASOUEECES = ELE LESDACE ASE E 
TIL LELLSE o; DALCABAAC 


Universal Knowledge Solutions s.a.1 158 


ENG Sub 

Public Sub LoadTitles(strCacheKey As String) 
Dim connection AS SaqlConnection 

Dim command As SqlDataAdapter 

DI SOLSELECLE AS SEE LAG 

DEM SEEDS ZS SEER 

Dim dataset As New DataSet () 


sqlSelect = "Select title, pub_id, price, notes, pubdate FROM 
MEI SSE 
StrDsn = "server=localhost;Uu1d=sajpwd=;database=pubs"™ 


connection = New SqlConnection (strDsn) 

command = New SqlDataAdapter (sqlSelect, connection) 
command.EFi1ll1l (dataset, "Author-Titles") 

Cache. Insert (strCacheKey, dataset, nothing, 
DateTime.Now.AddMinutes (60), TimeSpan. Zero) 

Cl SUS 

GJSCE LOLS 

<FONT S126=6> 

CASO: Lalel 1A—WIOLSEAEUSY CUNAE=W SEE VOCS 

€JEORTS 

<P> 

<ASP:DataGrid id="TitleList" HeaderStyle-BackColor="#aaaadd"™ 
BEACKCOLOE=S HH ECECEE E 

EUNEE = SEVE Y #3 


أحداث التطبيق 
تجعل أحداث التطبيق في ۸8۲.٤٣‏ الكثير من الأعمال أسهل. 
توفر الأحداث طرق جيدة للتحكم بتنفيذ النص البرمجي وتنظيمه. 


نستطيع استخدام أحداث التطبيق بإحدى طريقتين: 

- استخدام النموذج الأولي في ملف ×هءه.اوطهاي : 

سنقوم في هذه الحالة ببساطة بإضافة ملف النموذج الأولي للأحداث. تشبه هذه الطريقة لما ما كان يجري في 
سلف ٥N.م۸p‏ حیث كانت تجري کتابة معالجات لأحداث مٹل )5ہ ۸_0٥t1ھicاpمAp‏ أو 
.Session_OnEnd‏ 

- تحرير وحدات م٤٤1‏ النمطية: 

تعطينا وحدة م))1 النمطية المجال للعمل على طلب م))8 قبل تخديمه مj‏ aبJ ASP.NET‏ 

كط افا م ازات الما اترير خرل حه قى 6 A5۶‏ مسين. 
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ملاحظة : 
٠‏ يمكن أن يكون هناك استجابة من ×هءه.21طها6 ووحدة م))1 النمطية على نفس الحدث. 
۰ تدعم .ASP.N ۴٤1‏ 18 حدث خاص بالتطبيق كما تسمح لنا بإضافة أحداثنا المخصصة عن الحاجة. 


صيغة أحداث التطبيق والنموذج الأولي 


تأخذ أحداث التطبيق في ×هءه.1ةطه61 الصيغة : 


VB.NET في‎ 
Public Sub Application_OnStart (sender As Object, e As EventArgs) 
End Sub 
:٤# أما في‎ 


public Told Application OnStarl(ObIECL Sender, EventArés €) { 
} 


يحدد المعامل التي قمنا باستخدامه الغرض الذي قام بإطلاق الحدث إضافة إلى المعامل sعإ 8۷٥٣۲4‏ الذي 
يتيح المجال للغرض الذي أطلق الحدث بتزويدنا بمعلومات وتفاصيل عن هذا الحدث. 


يمكننا استخدام الصيغة السريعة دون تحديد اسماء المعاملات: 


FPFUbDLIG SUD ADDLIICALION OnSEAIE)) 
End SUb 


:C# وفي‎ 


GUDLICE VOl0 ASOLlICALION Onclalll) [{ 
1 


لا یمکننا في الصيغة السابقة الوصول إلى كعإ۲4١ءE۷‏ أو امل لذلك يفضل استخدام الصيغة المفصلة 


يمكننا تصنيف أحداث التطبيق إلى تصنيفين أساسيين: 
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2 أحداث يتم إطلاقها عند كل طلب؛ 
- أحداث شرطية يتم إطلاقها عند تحقق شرط متل الأحداث التي تم إطلاقها عند حدوث خطأ ما. 


صيغة أحداث التطبيق والنموذج الأولي 


الأحداث السابقة للطلب: 


تعرّف أحداث التطبيق السابقة للطلب بأنها الأحداث التي يتم إطلاهها أثناء كل طلب يتم توجيهه إلى تطبيق 
P.۴٤1‏ متل أحداث بداية ونهاية الطلب: 


حدث ication_OnBeginRequesاApp‏ : يجري إطلاق هذا الحدث مع كل طلب تتم معالجته من 
قبل .۸8۴.N٤٣‏ يختلف هذا الحدث عن الحدث المألوف S2۲٤‏ 0۸_0اةاممA‏ في نسخة ۸8۲ الذي 
يتم إطلاقه مرة واحدة عند تشغيل التطبيق. 

يمكننا استخدام هذا الحدث لتنفيذ نص برمجي قبل أي صفحة أو خدمة وب أو قبل أن يتمكن أي معالج طلب 
81۴P‏ من بدء العمل على أي طلب. 


الحدث Authenticate Request‏ ication_OnاApp‏ : يتم إطلاق هذا الحدث عندما تصبح 
SP. N E1‏ جاھز ة للتحقق من الطلب. يُسهل هذا الحدث علينا بناء نظام تحقق مخصص بحيیث نستطیع 
فحص الطلب وتنفيذ النص البرمجي الذي يحدد فيما إذا كان الطلب مقبولاً أم لا. 


® lنحد‏ ication_OnAuthorizationRequestاpمAp‏ : يعمل هذا الحدث بصورة شبيهة لحدث 


يُمكننا هذا الحدث من إنشاء وتنفيذ نصوص برمجية تحدد السماحيات الخاصة بالطلبات. 


الحدٽث ication_OnResolveRequestCacheاApp‏ : تمتلك ۸8P۴.N٤٣‏ آلیات تخزین صفحات 
وخدمات الوب. ف بدل تنفيذ الصفحة لكل طلب يمكن أن يجري تنفيذ الصفحة لمرة وتخديم طلبات أخرى 
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بالنسخة الستاتيكية الناتجة. 
ينطلق هذاالحدث عندما تصبح ۸58۴.٤1‏ جاهزة لتحديد كون الطلب سيتم تخديمه من الخبئ أم لا. 


صيغة أحداث التطبيق والنموذج الأولي 


:Application_OnAcquireRequestState دحنl‎ 

يتم إطلاق هذا الحدث عندما تصبح ۸5۴.٤٣‏ جاهزة لتلقي بيانات الجلسة من داخل إجراء ۴1 ۸SP.N‏ أو 
من خارجه أو من S۷٥۲‏ اSQ.‏ 

إذا قررنا استخدام غرض ١٥1وو6؟‏ مخصص كغرض ١0ذءوه‏ 18× مثلاء يمكننا تأهيل قيم ذلك الغرض 
RT‏ 

عند تسليم الطلب للصفحة أو لخدمة الوب سيكون الغرض 10۸ءوم؟1 × مؤهلاً بالقيم. 


:Application_OnPreRequestHandler Execute ٽدحİl‎ 6 

يتم إطلاق هذا الحدث قبل استدعاء معالج تخديم الطلب. في معظم الحالات يكون هذا المعالج هو معالج 
.Page‏ 

بعد إطلاق انحدث Application _OnPreRequestHandlerExecute‏ یتسلم معالج ۲1'۲۶ الطلب. 
يتم إطلاق الحدث التالي بعد الانتهاء من معالجة الطلب. 


e‏ انحدث ication_OnPostRequestHandlerExecuteاApp‏ : يتم إطلاق هذا الحدث فور الانتهاء من 
معالجة الطلب. في هذه المرحلة يكون لدى الغرض ع5١٠0مءع۸‏ بيانات يجري إرسالها إلى الزبون. 


ه الحدث ication_OnReleaseRequestStaeاApp‏ يقوم هذا الحدث بتحرير بيانات الجلسة وتحديث 
المعلومات المخزنة عند اللزوم. بعد إطلاق هذا الحدث لا يمكن تحديث معلومات الجلسة. 


انحدث UpdateRequestCache‏ _ication_OnاApp‏ يتم إطلاق هذا الحدٿث عندمl‏ تقوم ASP.NET‏ 
بتحديث خر ج الذاكرة الخبيئة بالطلب الحالي . 


٠‏ الحدث End Req ues‏ ication_OnاApp:‏ هذا هو الحدث الأخير الذي سيتم إطلاقه ويسمح لنا التحكم 
باستجابة التطبيق قبل إرسال ترويسات ۲۲۲[ مع الاستجابة. 
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صيغة أحداث التطبيق والنموذج الأولي 


فيما يلي مخطط تدفقي للأحداث الخاصة بالتطبيق: 


| Internet Information Sever 


Application_OnBeginReqliest 
Application_OnAuthenticateRequest A pplication_OnEndRequest 


Appl cation_OnAutharizeRequest Application On lUIpdateRequestCace 


Application_OnResolveRequestCache Applicatin_OnReleaseRequestState 
Application_On Acquire Reque stState Application_OnPostRequest Handler Execute 
A pplication_û nPreRequestHandlerExecıte | 
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كما هو مبين أعلاه يقوم 118 بتلقي الطلب وتسليمه إلى الإجراء 48۲.١٤1‏ عندها تبداً الأحداث المذكورة 
اقا بالانطلاق ابتداءاً ja‏ ication_OnBeginRequestاpمAp‏ وبصورة فورية. 

قبل أن یتم استدعاء معالج #1۲۶ يجري إ¦lÛڻق .Application_OnPreRequestHandlerExecute‏ 
وفور انتهاء تنفيذ معالج 117۴ من التنفيذ ينطلق الحدث 
.Application_OnPostRequestHandlerExecute‏ 

أخيراً وقبل تسليم الاستجابة إلى 118 يتم إطلاق انحدث .Application_OnEndRequest‏ 


صيغة أحداث التطبيق والنموذج الأولي 
هناك حدثان آخران بنتميان إلى مجموعة الأحداث التي تتكرر مع كل طلب ولكنهما ينطلقان عندما تصبح 
البيانات جاهزة ليتم إرسالها إلى الزبون. 


تفعل ۸5۲.٤٣‏ بشكل تلقائي ١ء٤8‏ مما يعني أن المخدم لن يبدا بإرسال البيانات إلى طالبها إلا حين 
تصبح هذه البيانات جاهزة. 


عند تفعیل 2٣۲1ء] 8u‏ ينطلق الحدثان llتjlıl‏ ڊaد :Application_OnEndRequest‏ 

الحدث ication_0nPreSendRequestHeadersاApp‏ قبل إرسال ترویسات H۲۲۴‏ إلی الزبون 
اف اا 

الحدث ication_OnPreSendRequestContentاpمA‏ قبل إرسال الاستجابة إلى الزبون مرسل 
الطاب . 


الأحداث الشرطية الخاصة بالتطبيق 


ذكرنا وجود تصنيفين لأحداث التطبيق في ۶.٤١‏ 48: تناولنا الأول المتعلق بالأحداث التي تتكرر مع كل 
طلب وسنغطي الآن الأحداث الشرطية. 

تعرف الأحذاث الشرطية بأنها الأحدات التي يمكن أن تظهر أر لا تظهر خاال معالجة طلب. 

فعلى سبيل المثال» عند تشغيل التطبيق للمرة الأولی ینطلق الحدث ۸5)۲۵ ۸_0٥1اهء:ام‌م۸‏ أو عند ظهور 
خطأً في التطبيق ينطلق الحدث Application _Error‏ . 
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ه الحدث «5٤4۲٤‏ 0_١٥10)هءنامم4:‏ ينطلق هذا الحدث عندما يتم تشغيل التطبيق للمرة الأولى وهو بعكس 
الحدث Request‏ ication_OnBeginاApp‏ لا یُطلق مع کل طلب. يمکننا استخدام هذا الحدث لتجهیز 
مثال: استخدام هذا الحدث لتأسيس اتصال مع قاعدة البيانات والحصول على بعض البيانات. 


٠‏ الحدث «٤1d‏ 0_0ناةناpمA:‏ يظهر هذا الحدث لمرة واحدة أيضاً وهو مقابل للحدث 
Appi cation _ a1‏ ويتم إطلاقه عندما يتم إيقاف تشغيل التطبيق. يمكن استخدام هذا الحدث كحدث 
تنظيف. يتضمن عمليات إغلاق الاتصال مع قاعدة البيانات تفريغ البيانات من الخبئ . في الواقع تكون معظم 
العمليات السابقة غير ضرورية كون K1‏ تقوم بعملية التنظيف تلك وتحرير الذاكرة المحجوزة للتطبيق» إلا 
فل داف اراد لك اة افا 

أحداث التطبيق الشرطية 


٠‏ الحدث ١5)۲٤‏ 0«_0اووم؟ يتم إطلاق هذا الحدث عندما تبداً جلسة مستخدم ما في تطبيق 
۸P.‏ . يمكننا استخدام هذا التطبيق لتنفيذ نص برمجي خاص بالمستخدم كعملية إسناد قیم لغرض 


.Session 


٠‏ الحدٿث ١«٤م10«_0ءوع؟:‏ يتم إطلاق هذا الحدث (المقابل لحدث بدء جلسة) عند انتهاء جلسة 
مستخدم. يمكن استخدام هذا الحدث لحفظ معلومات الجلسة أو للتجوال في بيانات الجلسة لتسجيل ما هو مهم 
لنا ضمن قاعدة البيانات . 


® llنحدث :Application_Error‏ يتم إطلاق هذا الحدث عند ظهور خطأاً ضمن التطبيق. يعتبر هذا 
الحدث شديد الأهمية لأنه يساعدنا في التقاط الأخطاء ومعالجتها وفي إرسال بريد لمدير النظام بتفصيلات عن 


الخطاً. 


الحدث 4ءsەمsءication_0”2iاApp:‏ يتم إطلاق هذا الحدث عندما يتم إيقاف تشغيل وينتهي €[R‏ 
من تحرير ذاكرة التطبيق. ولكن هذا الحدث قليل الاستخدام فعلياً. 


لايعني وجود 18 حدث في ۸8۴.٤1‏ أنه یتوجب استخدامها کلها في کل تطبیق ویبقی تقدیر استخدام 
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مثال إضافة تذييل إلى جميع الصفحات: 

ذكرنا أن الحدٿ †sَicati0on_OnEndRequeاpم‏ يتم إطلاقه في نهاية الطلب فور آ قبل إرسال الاستجابة 
إلى طالبها. لنفرض أن مزود خدمة أنترنت يريد إضافة تذييل إلى جميع الصفحات التي يتم تخديمها باستخدام 
.ASP.NET‏ یمکن أن یکون ملف ×ھیه.21طها6 عندھا من الشکل: 


<Script runat="server"> 

Public Sub Application_OnEndRequest (sender As Object, e As 
EventArgs) 

Response.Write ("<hr si1zé6=1>") 

Response.Write ("<font face=arial size=2>This page was " _ 
CE Seve d OV ASB NEE GE OIE ) 

Cl SUS 

€CJOECELOLS 


في المثال أعلاه استخدمنا التعبير )ا 8e. W‏ ¬0مءRe‏ لإظهار العبارة ”... “This page Was‏ 


مثال تحميل بيانات مخصصة بالمستخدم: 

تقوم العديد من المواقع بتخصيص نفسها حسب طبيعة مرسل الطلب. فماذا لو أردنا التخصيص بالنسبة 
لمجموعة وليس لمستخدم فريد. 

مثلاً إذا أردنا تقسيم المستحدمين إلى مجموعات هي 6014» وإ۷6[ز؟ء و8026 ونريد لكل مجموعة من 
هؤلاء الوصول إلى موارد غير متاحة للمجموعات الباقية. 


نستطيع بسهولة بناء مدير حالة يساعدنا عند استخدام انحدث ja Application_OnAquire Request‏ 
تحديد لمن يعود كل طلب واستحضار البيانات المناسبة له. مثال: 


<%@ Import Namespace="System.Xml" &%> 

SEEIOE EUNaAlE — SEE EELS 

Public Sub Application_OnAcquireRequestState( _ 
sender As Object, e As EventArgs) 

Dim dom As New XmlDocument () 

Dim customerType As String 

' Grab the customerType from the QueryString 
USE OME EI VOCE > REIUESE OUEST (LOWS OME EN YSE Û) 
' Check for values 

2 SNothing (customerType) ) Then 

customerType = "Bronze" 

AS E 

' Load Ehé approprlialée KML FIle 


اص 
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Select Case customerType 

Case "Gold" 

dom. Load (Server .MapPalth (Gold. xXmnl"}) 
Case "Silver" 

dom. Load (Server.MapPath("Silver.xml") ) 
Case Else 

dom. Load (Server.MapPath ("Bronze.xml") ) 
End Select 

Session ("WelcomeMsg"™) = _ 

ClO. SSLECESLRILEONONE (Y/CUS COME / WE LEOMEY ) . LANE LOSE 
End SUBS 

GJ OEE OES 


معالجة أخطاء التطبيقات 
لما کانت ۸p.‏ تستعمل C۸‏ یمکننا استخدام KC]‏ لبناء تطبیقات وب. 


تعتبر معالجة الاستثناءات بطريقة 1٥٤ةء/رإ1‏ أحد المزايا الأساسية في .0R‏ لكن وجود هذه الأمكانيات 
القوية التي توفرها هذه البنية» لايمنع من بناء نصوص برمجية تحوي الكثير من العلل. 


فعلى سبيل المثالء قد نكتب نصا برمجياً يقوم بالاتصال بقاعدة بيانات وبالقراءة منها. كما يمكن أن نغلف هذه 
النص البرمجي في كتلة اءةء/ر۲)ء عندها يمكننا في حال عدم التمكن من الاتصال معالجة هذا الخطاً 
بصورة مناسبة. 

ولكن ما الذي سيحصل إذا ظهر الاستثناء خار ج كتلة ا٥ةء/رع)‏ ؟ سيتم إظهاره كخطأاً تشغيل يزودنا 
بتفاصيل عن الخطاًء وعن مكانه وعن العمل الذي كان التطبيق يقوم به. 


یمکننا بالنسبة لصفحات P.NE8E1۲‏ ۸5 اعتماد الحدث ۲٣٥١‏ ٤_ععھP‏ لالتقاط جمیع الاخطاء التي لم تتم 
سالا 


أما إذا قررنا التقاط جمیع الأخطاء على مستوی التطبیق فإن ۲۲٥۲‏ ٤_١10اهء‏ امم يساعدنا في ذلك: 
Import Namespace="System.Diagnostics" %>‏ @%5< 
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E as EventArgs) 


Dim LogName As String = "Web_Errors" 

Dim Message As String 

Message = "Url: " & Request.Path 

MESSAGE = MESSAGE + JY ErrOcg ¥ & Seer “CEC LAS EI E OIE ¢, OSE 1 ME) 


OC). SOULE CE = LOCGMNEMIE 

TOG MEIECBRELY (MeS SAG e, BHVENE LOSER E YI VOEe BEE OE) 
End Sub 

VY SOE OIE 


<script language="VB" runat=server> 
BUbIlIE SUS ASOlIICaAEION BEE Or (Sender aS OMJeCE, 


۲ 


Create event log if it doesn't exist 

IF (Nol EvenNLLOG.SOUrCEEXLSTES (LogName) ) Then 
EventLlLog.CreateEventSource (LogName, LogName) 
ENO 1E 
' Fire off to event log 
Dim Log as New EventlLog 


قمنا في المثال أعلاه باستير اد فضاء الأسماء sعناوممعهSystem.Di‏ لأننا سنقوم باستخدام صفوف في هذا 


الفضاء لكتابة سجل الأحداث. 


قمنا بعدها باستخدام الحدث ٤۲0۲‏ icat10«n_0امpمA‏ لإنشاء ومجموعة من المتحولات. 

ثم قمنا بالتأكد من وجود سجل للأحداث باستخدام الطريقة 10ء۵8×1١إuه؟.‏ فإذا لم نجده نعمل على إنشاءه. 
قمنا بعدھا بإنشاء مٹیل من الصف ٤۷٥٣٤1٥2‏ باسم ع٥[‏ وقمنا باستخدام الطریقة W٤٤٣ ٤)۲۷)0‏ لإدراج 
رسالة ضمن سجل أحداث Widows‏ . 

في حال ظهور أي خطأ في تطبيقنا سيتم تسجيله ضمن سجل الأحداث المخصص المسمی ۴۲۲0۲۵_ا۷e.‏ 


لا بد من الملاحظة هنا بأننا كتبنا فقط 10 أسطر لأداء عملية قد تتطلب 60 سطرا في ۸8۶ سلف 


.ASP.NET 
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عنوان الموضوع: 
إدارة البيانات في .×"٤٣‏ 


الكلمات المفتاحية: 


اتصال» أمرء غرض»› واصفةء تأشيرة» طريقةء خاصة. 


لخے : 
د زوك E NET‏ قوية من التقنيات التي بإدارة البيانات والتعامل مع عدد کبیر من مصادر البيانات سواء كانت 
هذه المصادر متمثلة بقواعد بيانات علائقية أو وثائق متل وثائق ا1١×.‏ 


أهداف تعليمية: 
يتعرف الطالب في هذا الفصل على: 
ه٠‏ أغراض إدارة البيانات في N۴٤۲۰‏ على كيفية استخدامها 
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إدارة البيانات في ASP.NET‏ 


سنغطي في هذه الجلسة والجلسة القادمة المواضيع المتعلقة بإدارة البيانات في ۴.٤٣‏ ؟۸. ونقصد هنا 
بتعبير إدارة البيانات عمليات الوصول إلى البيانات المخزنة في ملفات وتطبيقات أخرى ومعالجتها. 


نسمي في الإطار العام مصادر المعلومات بمخازن البيانات. 


تمن لر عل 50 مخمر عة ون لفرت اي كى شات ورضرل مقف إلى ادات المضمة 
حيصا لاتا م NÊT‏ 


مخازن البيانات والوصول إليها: 

يرتبط مفهوم إدارة البيانات بمصادر البيانات العلائقية متل قواعد البيانات» ولكن تقنيات إدارة البيانات في 

N1‏ تقدم إمكانيات أخرى متميزة منها: الاتصال والتعامل مع ملفات ۷× والتقنيات المرتبطة بها. 
تاريخيأء كانت قواعد البيانات عادة مبنية على ملف وتستخدم طول سجل محدد كما هي الحال في ملفات أ»ا. 
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إذ كانت تجري قراءة الملفات إلى جداول من قبل برامج قواعد البيانات أو تقنيات الوصول إلى البيانات» 
وكانت تطبق قواعد موجودة في ملفات أخرى لربط سجلات من جداول مختلفة بعضها ببعض. بعد نضوج 
هذه التقنيات ظهرت قواعد البيانات العلائقية لتوفر طرق تخزين أفضل مع الطول الديناميكي للسجل وتقنيات 
وصول أكثر فعالية للبيانات. على أي حال بقي مكان التخزين الأساسي هو قاعدة البيانات . 


الانتقال إلى البيئة الموزعة: 

في السنوات الأخيرةء تغيرت العديد من المتطلبات وآليات عمل التطبيقات في معظم الأعمال وتم الابتعاد عن 
مفهوم قاعدة البيانات العلائقية المركزيةء وأصبحت البيانات موزعة بين مخدمات البريد الالكتروني ووثائق 
المكتت و أماكن مط آأخر سم ضفن قراغ الياتات ضا 


إدارة البيانات في .×N٤1‏ 


ما تقدمه .N٤1‏ فعلياً في هذا المجال. 


سنبدأً بإعطاء لمحة عامة عن جميع صفوف إدارة البيانات في ..E۲‏ لنرى كيف تنسجم جميع أغراض إدارة 
البيانات مع بيئة البرمجة المهيكلة التي تقدمها .×٤1‏ 


فضاء الأسماء: 
َ جميع صفوف إدارة البيانات العلائقية على فضاء الأسماء a٤2ل.1ءاءرء‏ ويطلق عادة يطلق اع0.1لج 
على فضاءات الأسماء الوجودة في الجدول التالي: 
فضاء الأسماء الوصف 
System.data‏ يتضمن جميع الأغراض الأساسية المستخدمة للوصول إلى 
وتخزين البيانات في قواعد البيانات العلائقية. من هذه 
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الÎغرlض: .DataRelation y DataTable y Dataset‏ 
تكون كل من هذه الأغراض مستقلة عن نمط مصدر البيانات 
والطريقة التي نتصل بها بهذا المصدر. 
System.data.com‏ تحتوي الصفوف الأساسية المستخدمة من الأغراض الأخرى 
وخاصة الأغراض العامة من فضاء الأسماء ا5٥01‏ و 
1ا]S.‏ بصورة عامة لا نقوم باستيراد فضاء الأسماء هذا 
في تطبيقاتنا. 
ا ال و يحتوي الأغراض التي تخد م للاتصال مع مصدر البيانات 
باستخدام مزود ا0-O1e OleDbConnection Jia‏ « 
.01€Db€0mmand‏ ترث هذه الأغراض طرق وخصائص 
من الصفوف المشتركة 
System.data.SqICI‏ تحتوي الأغراض التي يمكننا استخدامها للاتصال مع مصادر 
البيانات عبر سياق من البيانات الجدولية الخاصة ب ©$ 
e٣‏ فقط. حيث توفر أداء أفضل بإزالتها بعض الطبقات 
الوسيطة المطلوبة من اتصال 8_٥28‏ 01. ترث الأغراض 
متل SQLConnec101‏ و QL 0mmand‏ 3 من الصفوف 
المشتركة ك ط2ء01 الخصائص والطرق والأحداث. 
تحتوي الصفوف اللازمة لاستخدام أنماط البيانات في قواعد 
البيانات العلائقية متثل 15٥۲۷٥١‏ 50والمخنلفة عن تلك القياسية 
System.Data.SqIT‏ في SqlMoney. Sq1Date Time ضlرغأك .NET‏ و 
.SqlBinary ype‏ 
يحسن استخدام هذه الأغراض الأداء بشكل ملحوظ ويقلل 
أخطاء التحويل بين أنماط البيانات. 


ما تقدمه .N٤1‏ فعلياً في هذا المجال. 


سنبدأً بإعطاء لمحة عامة عن جميع صفوف إدارة البيانات في ..E۲‏ لنرى كيف تنسجم جميع أغراض إدارة 
البيانات مع بيئة البرمجة المهيكلة التي تقدمها .×٤1‏ 
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إدارة البيانات في .×N٤1‏ 


هناك أيضاً سلسلة من فضاءات الأسماء الحاوية على صفوف يمكن استخدامها للتعامل مع ملفات ۷1× بدلا 
من استخدام قواعد البيانات العلائقيةء تكون هذه الأسماء مبنية على 01 ×.0عاكر؟. 


تحتوي الأغراض الأساسية اللازمة لإنشاءء وقراءة › 
وتخزين» وكتابة ومعالجة ثائق ]۷× بحسب توصيات 
.W3C‏ 


System.Xml 
تحتوي ۸٨ع uء0 10ص بالإضافة إلى سلسلة من‎ 
الأغراض التي تمتل أنواع مختلفة من العقد في وثيقة‎ 
.XML 
تحتوي الأغراض المسؤولة عن إنشاءء وتخزين» ومعالجة‎ 
System.Xml.Schema 


الهيكل والعقد المحتواة في هيكل وثيقة -ا١×.‏ 


يحتوي مجموعة من الأغراض التي يمكن استخدامها 
System.Xml.Sirializa‏ 
tion‏ 


ی ا 
والكتابة واستعلام عن وثائق ]۷1× باستخدام غرض مبني 
System.Xml.Xpath‏ على 1ا۾P×.‏ تتضمن أغر اض Xpath Document Jia‏ 
و Xpath Nav0‏ والأغراض التي تمتل تعبيرات 
.XPath‏ 

يحتوي الأغراض اللازمة لعملية تحويل ملف ۷1× إلى 
System.XmI.XsI‏ تنسیقات أخری باستخدام 51× و S11؟×.‏ يكون الغرض 


الأساسي فيه ھg XsITransfor‏ 


استيراد فضاءات الأسماء اللازمة للعمل مع مصادر البيانات 


لا بد للصفحات التي تستخدم أغراض من مكتبة صفوف إطار العمل ..E1‏ أن تستورد فضاءات الأسماء 
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الحاوية على الإغراض التي تريد إنشاء مثيل عنها. يجري استيراد الكثير من هذه الفضاءات تلقاتيا. 
لكن فضاء أسماء إدارة البيانات ليس من تللك الفضاءات التي يتم استيرادها تلقائياًء لذا يجب علينا استيراده 


بصورة صريحة في النص البرمجي: 


استيراد فضاء الأسماء 2a‏ 5."ءاSys:‏ 

للوصول إلى قواعد البيانات العلائقية لا بد لنا من استخدام فضاء الأسماء 8/5.02 على الأقل وأي 
مj System.Data.OleDb‏ أر System.Data. Sq Client‏ اعتماداً على الطريقة التي نود الاتصال 
بها مع مصدر البيانات وذلك بالصيغة: 


<%$@GImport Namespace="System.Data" %> 
<$@Import Namespace="System.Data.OleDb" %> 


أو 
<$%$@GImport Namespace="System.Data" %>‏ 
<%$@GImport Namespace="System.Data.SqlClient" %>‏ 


يمکن في ۷/8.٤‏ استخدام كأا0م"| وفي C#‏ استخدام ٣9‏ ایل 


هناك حالات خاصة نضطر فيها لاستيراد فضاءات أسماء أخرى كحالة إنشاء عنصر من الغرض 
Data r ableMapping‏ حيث يتوجب علينا استير د فضl« las .System.Data.COMmmoOn slau‏ 
يتوجب علينا استيراد .034.5٩|۲۷8‏ "5/51۳ عندما نريد استخدام أنماط بيانات من الأنواع التي 
يستخدمه Sq|S676۲‏ 


استیراد فضاء الأُسماء ٥.)‏ ءSy:‏ 

للوصول إلى بيانات 11× باستخدام الأغراض في صفوف مكتبات 6".» يمكننا غالبا غض النظر عن 
استير اد فضاء الأسماء الأساسي 6".×"1أكئS۷‏ . 

على کل حال سنضطر إلى استير اد فضاء الأسماء 2۸م×.۳.×۳1 S۷‏ عندما نريد إنشاء غرض 
.Xpath Document‏ 

وسنضطر أیضا لاستیراد فضاء الأسماء |ئ×.۳1×. 8۷88 عند استخدام الغرض ×8|۲۲۸۸80۲۳١‏ عند 
إجراء عمليات تحويل من جهة المخدم على وثائق ا1١×.‏ 

کما یلزمنا استیر اد فضاء أسماء 2٣٥c۸ءS.١m×. System‏ عند العمل مع ال كج٣‏ ٥۸ءŠ‏ (المخططات 
والهياكل). 

أما بالنسبة لأغراض مثل 8۴206۲ 9٣21ل‏ اة 1۷× فلا نحتاج فيها إلى استيراد 
.System.Xml.Schema‏ 
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في حال نسينا استيراد أي من فضاءات الأسماء اللازمة سنحصل على رسالة خطأً من الشكل: 
Server Error in '/7035' Application.‏ 


Compilation Error 


Description: An error occurred during the compilation of a resource required to service this request. 
Please review the following specific error details and modify your solirce code appropriately. 


Compiler Error Message: BECUZ Type SAlConnscliorr' 15 nol HERNE 


SOUrCE Error: 


Line 43: 

Linëê Ad: 'Erêéatê ã hêw têonhsctiîon object usîng thé cêûnnêztîon StFÎ fû 
LE 45: Dim ohbjConnect A5 New S5qlCaonnection(strConnect) 

Line 4E: 

Line 4F: 'gpen the connection to the database 


Source File: © Ynetp Ubi oor OSTA ata-accESSdata0 1 idatareader-sql.a25p*» Line: A5 


Shew petailed Gompiler Output 


Shew Complete Compilation Source; 


Version Information: Microsoft HET Framework yersion:1.0.361 7.0, ASP.NET Yersion:1 .0.3617.0 


أغراض ۸20.١٤1‏ الأساسية 


اعتمدت طريقة الوصول التقليدية إلى البيانات -والتي استخدمت تقنية ۸00- على غرض رئيسي وحيد هو 
»Records€)‏ وكانت التقنية تتلخص في: 

OLE-DB رڊe‎ ODBC jİ 0LE-DB دوزja تأسيس اتصال بقاعدة البيانات باستخدام‎ ٠ 

۵ تفا ارام غل الاتضل الغا 

۵ تخزین البيانات ضمن غرض ٥0۲5٥ء۸‏ لاستعادتها 

۰ يمکن لهذا السیناریو أن يتم باستخدام الغرض ٤٥٥٥٣٣۵4‏ أو عن طریق غرض Connecti0¬‏ 
مباشرة 

٠‏ لإدراج أو تعديل البيانات يمكن ببساطة تنفيذ عبارة 5Q1‏ أو إجرائية مخزنة باستخدام الغرض 


R‌ec-0]لsع) و الغرض 4٣2ص صه٥٤ دون استخدام الغرض‎ Connection 
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يعتمد الوصول إلى البيانات في .NE١‏ على نفس الخطوط العريضة ولكن باستخدام مجموعة أخرى من 
الأغراض. قد تبدو هذه الأغراض مشابهة لكنها مختلفة بشكل جذري داخلياً مع اختلاف في الأداء ومرونة 
أكبر. إذ تعتمد أغراض الوصول إلى البيانات في .N٤1‏ على غرضين أساسيين |JأوJ DataReader‏ 
والثاني هو (45٥1‏ . ينفذ كلا الغرضان العمل الذي كان الغرض )0۲0۴٥ء۸‏ يقوم به. 


يكمن الفرق الرئيسي في أن الغرض ١ء44٠‏ ۸اه يساعد في الوصول إلى البيانات باتجاه واحد وللقراءة 
فقط. في حين يوفر الغرض ۴١ء4(‏ آلية للتعامل مع أكثر من مجموعة من الصفوف من نفس مصدر 
البيانات» حيث يمكننا إنشاء غرض 045٥1‏ من بيانات موجودة ضمن مصدر البيانات» أو من ملئها بصورة 
مباشرة صف تلو الآخر باستخدام النص البرمجي. 


يحتوي كل جدول ضمن الغرض 0561 على معلومات حول القيم الأصلية للبيانات أثناء عملنا عليهاء 


يحتوي الغرض 03186 يحتوي معلومات تصف محتوي الجداول» كأنماط الأعمدةء القواعد» والمفاتيح . 
نت اک دا أن التركيز في الغرض 1٥5هة(‏ هو القدرة على العمل بصورة دقيقة وفعالة في بيئة 


يحافظ الغرض ٥4)5٥‏ على محتوياته ويستطيع تحميل معلومات من وثيقة ا۷ الحاوية على بيانات 
مهيكلة بالتنسيق الصحيح. 


أغراض ۸20.N ٤1‏ الأساسية 
غراض :Connection‏ 
يشبه هذا الغرض بصورة كبير ة الغرض المستخدم مع ۸00 ويحوي خصائص مشابهة له. يستخدم هذا 
الغرض لوصل غرض ٥0۳٣۳۵٣4‏ بمخزن البيانات . 
OLE_D8B دوjn‎ ga OleDbConnecti0ټ¬‎ ضرغll‎ pad ®‏ 
٠‏ يستخدم الغرض ١٥!†ء‏ ”,ه٣541‏ ما يسمى 1(5 مع نظام إدارة قواعد البيانات SQLServer‏ 
کان من الممكن سابقا لغرض ٥٥۸٣6٥٤1٥۸‏ تنفيذ تعليمات 5Q1‏ على مصدر البيانات أو فتح غرض 
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.NRecordSet‏ اما في SP.N٤1‏ فهذا غير ممكن. على كل الأحوالء تؤمن أغراض الاتصال السابقة 
الوصول إلى المناقلات التي تكون قيد التنفيذ على مخزن بيانات معين. 

الطرق الأساسية لأغراض الاتصال: 

من هم الأغر اض المستعملة لكل من غرضي الاتصJi SqlConnection g OleDbC0n ect‏ 


الطريقة الوصف 
۳ تقوم بفتح اتصال إلى مصدر البيانات باستخدام الإعدادات الحالية مثل 
التي تحدد معلومات الاتصاJ‏ lلnطذوب ConnectionS{ri¬g‏ 


Close‏ تقوم بإغلاق الاتصال الحالي مع مصدر البيانات. 
pgãî Transaction BeginTransac‏ ببداً مناقلة مع مصدر البيانات وتعيد غرض 
tion‏ 
الدى يمكن استخدامه لإتمام أو إلغاء المناقلة. 
مثال: 
SQL Server Provider Sample‏ ' 
Dim CoOonnNSLLE AS SITING = "dala SoOUrCe=(localj; & _‏ 
AL ESLE CAEALOG NO ELAM USO 1ES‏ 
Din CAN AS NEW SCLCONNECE LOM (EOS)‏ 
CHIN: OBEN)‏ 
USE LMê COMMECELON 1M MEEEus‏ ' 
li Cn. SLEAEE = COMMECLLOMSLALE . Ooo MEM‏ 
ENCLOSE U)‏ 
AS EE‏ 
أغراض ۸2D0.N ٤۲‏ الأساسية 
أغراض الأوامر: 


تشبه هذه الأغراض متيلاتها ٥٥1١14110‏ في ۸50 وتمتلك نفس الخصائص» وت ل غر کن 
Connection‏ ع غرض DataAdapter ضرغèغوs DataReader‏ 

يستخدم الغرض ٣٣214‏ 0٤0ء1٥0‏ مع مjزود OLE-D8B‏ 

SQاSء مع خدمات البيانات الجدولية في إ۷‎ $41٣٥ يستخدم الغرض ل21٣١ ط‎ ٠ 

يسمح الغرض ٥٥٠"4‏ بتنفيذ عبارات 5Q1‏ أو إجرائيات مخزنة على مصدر البيانات. يتضمن 
هذا إعادة مجموعة صفوف (حيث نستخدم للوصول إليها غرض آخر كالغرض ١ء‏ ل2٠‏ ۸اه( أو كالغرض 
Adapter‏ t2ه()‏ أو إعادة قيمة وحيدةء أو إعادة عدد العناصر المتأثرة بالاستعلامات التي لا تعيد مجموعة 
صفوف 


Universal Knowledge Solutions s.a.1 177 


الطرق الرئيسية الخاصة بأغراض الأوامر: 


الطريقة الوصف 
0m mand ext‏ تقوم بتنفيذ الأوامر المعرفة في الخاصة 
والمرتبطة ١٥10اءع‏ ممه باستخدام الاتصال المعرف بالخاصة 


ا أو Delete‏ و date‏ p€باستعلام‏ لا يعيد أي صفوف (كتعليمة 
). تجري إعادة رقم صحيح يعبر عن عدد الصفوف التي ۲۲٤ئ1‏ 
تأثرت بهذا الاستعلام. 
باستخدام 2۸11٥×)‏ اه تقوم بتنفيذ الأمر المعرف في الخاصة 
. تعيد هذه الطريقة ١10اءمم”ه٣الاتصال‏ المعرف فى الخاصة 
ExecuteReader‏ 


متصل مع مجمو عة الصفوف في قاعدة المعطيات ۲ء ل2ع]غرض 
بشكل يسمح بالحصول على الصفوف. 

باستخدام ا×٥1 00٣4۸4‏ تقوم بتنفيذ الأمر المعرف في الخاصة 
. يعيد قيمة وحيدة هي 00١٠١٤٥٥٤10١‏ الاتصال المحدد في الخاصة 
ExecuteScalar‏ العمود الأول من السطر الأول من مجموعة الصفوف التي يعيدها 
الاستعلام» ويتم إهمال جميع القيم الأخرى المعادة. هذه الطريقة 
سريعة وفعالة عندما يكون المطلوب إعادة قيمة وحيدة فقط. 


مثال: 


OLE DE BEOMI GEE SAMS le 
DIM SLESOL AS SLILING = SELECT * FROM CUSTLOMEeL” 
Dim CMS AS Mey OLED OCOMINAREAK SEE SOL TEAR) 


' SQL Server Provider Sample 
Dim SEESOL AS SEEING — SEECEN 1 HROM CUSEOMEE SE 
Dim Cmé AS New SGl1lCoMmand(SIrESOL ,Chn) 


أغراض ۸20.١.٤‏ الأساسية 


:Data Adapter أغراض‎ 
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يعتبر هذا النوع من الأغراض غا دا يقوم بوصل غرض 14 2ه أو أكثر بغرض ع545 

OLE-D8 المستخدم مع مزود‎ 01٥(2) A dap )ء١ الغرض‎ ٠ 

M58 ؟Q1‎ Sء۷‎ e الغرض ١عامةل 541244 المستخدم مع خدمات البيانات الجدولية الخاصة ب‎ ٠ 
توف هذه الأغراض أربعة خصائص تعرف الأر امن المستخذمة للتعامل مع البيانات في مخزن اليانات:‎ 
DeleteCommand g UpdateCommand ڪ‎ InsertCommand gy SelectCommand 

حيث تشكل كل من هذه الخصائص مؤشر إلى غرض ٥٥1١۳2١4‏ (يمكن لكل هذه الأغراض الاشتراك 


بغرض C0۸1۴ ٥)10۸‏ وحید). 


Command 


Connection 


CommandText 
CommandType 


Command 


DataAdapter 


SelectCommand 
UpdateCommand 
InsertCommand 


Connection 


CommandText 
CnmmanrTypne 


Command 


Connection 


DeleteGCommand 


DataSet 


ConnectionString | 


Connection 


CommandText 
CommandType 


Command 
Connection 


CommandText 
CommandType 


أغراض ۸20.N ٤1‏ الأساسية 
الطرق الأساسية التي تدعمها أغراض ١ء)مa‏ 04)4۸ : 
تقدم کل من أغر اض OleDbData Adapter‏ و Sg] ata Adapter‏ مجموعة من الطرق للعمل مع أغراض 
6 التي تطبق عليها.أهم تلك الطرق ثلاثة هي: 


الطريقة لوضف 
tet Fill‏ لتأهيل الغرض 214 00۳٤٨1ع5تقوم‏ بتنفيذ الأمر 
ك من مسار الاق كا مكو اض اها ات 
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بالتعديلات 45٥1‏ (المعلومات المتوفرة ضمن جدول في غرض 
التي تمت على البيانات في مصدر البيانات الأصلي إذا كان هناك 
مفتاح رئيسي يميز صفوف البيانات في الجدول ضمن غرض 
Dataset.‏ 

FillSchema‏ لاستخلاص البنية الهيكلية لجدول 214١٣012٤1ء1eاع5تستخدم‏ الأمر 
مع 2256٤‏ من مصدر بيانات وتقوم بإنشاء جدول فارغ في غرض 
جميع القيود التي تحددها تلك البنية. 

sert Command «UpdateCommand «< Update‏ n]تقوم‏ باستدعاء الأوامر 
> لکل صف تم تعدیله أو حذفه من الغرض Delet)۵٥0٣۸ ٣214‏ 
بحيث يجري تحديث هذه البيانات ضمن مصدر البيانات 5)5٥)‏ 
الأساسي» باستخدام التعديلات التي تمت على محتوى الغرض 
DataSet.‏ 

المستخدمة مع غرض 1ء2 8ء ةلم لاتشبه هذه الطريقةء الطريقة 
لا يتم التعديل على 40ولكن في حالة Recordset aû A50‏ 
أكثر من جدول. 


مذال: 


DIUM CONASEE AS SE ANEG = ECOL =VEBDOLEHDS . LF DAA SOU COS & 
ACE NSAME HES N DAWA NTE SDAA DECL 


DIM SLESOL &S SIEECING = SELECT ™ FROM BEodUetl sS 


Dim oda As New OleDbDataAdapter (strSQL, connStr) 


Dim cmdInsert As New OleDbCommand (“INSERT INTO Products” & _ 
*(OEOCUEL AE, EO Meme) VALUES (10, eA) 


OCI; MOE E COMMA = EMCEE E 


أغراض ۸20.N ٤1‏ الأساسية 
الغرض )ع54)a5:‏ 
يقدم الغرض (45٥1‏ أساسيات التعامل مع قواعد البيانات العلائقية ووسائل تخزين البيانات في بيئة غير 
نقوم بتأهيل هذا الغرض من مخزن بيانات» ثم نقوم بالتعامل معه في حالة غير متصلة مع هذا المخزن» تم 
نقوم بالاتصال وإتمام التغييرات على مخزن البيانات حسب الحاجة. 
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تتلخص الفروق الأساسية بين الغرض (45٥61‏ والغرض 0۲45٥ء۸‏ ( في 450) بمايلي: 


° يمكن لغرض 861هه( أن يتعامل مع أكثر من مجموعة صفوف ويحتوي معلومات تخص العلاقة 
بينها» في حين لا يقدم الغرض 1٥ء۵5١0ء٥۸‏ سوى إمكانية التعامل مع مجموعة صفوف واحدة. 
° يوفر الغرض 02)5٥‏ وصول غير متصل إلى البيانات بصورة آلية. 


يكون كل جدول في الغرض (25٥1‏ عبارة عن غرض من النو ع ٥1ا41(‏ ينتمي إلى المجموعة 
6 . ويحتوي كل غرض ء1طa414٥‏ على مجموعة من أغراض س٠‏ ۸#هاه0 ومجموعة من أغراض 


.DataColumn 


هناك أيضاً مجموعات خاصة بالقيود كقيد المفتاح الأساسي والقيم التلقائية والعلاقات بين الجداول . 


DataSet DataTable 
Relations Collection Rows Collection CGhildRelations 
کم‎ Gollection 
جم‎ 
|_Relation | | DataRow | ÎT Remi. | 


Tables Collection 


[DataTable | 


Columns Collection ParentRelations 
Collection 


سڪ حع 
[Datacoumn] | Û Remon‏ 


Constraints 
Collection 


[[Gonstraint | 


Defaultyiew 


و أخير آ لدينا الغرض ۴۷عu11۷1ه]ع(‏ الخاص بكل جدول والمخصص لإنشاء غرض wء‏ 2)۷1( على ذلك 
الجدول» وذلك لتقديم إمكانيات البحث في البيانات والتعامل معها أو ربطها بعنصر تحكم. 


أغراض ۸20.١.٤‏ الأساسية 


الطرق الأساسية الخاصة بغرض ا٥؟هاه5:‏ 

يقدم الغرض 561 مجموعة من الطرق التي يمكن استخدامها للتعامل مع محتويات الجداول أو للتعامل 

مع العلاقات القائمة فيما بينهاء مثل عمليات مسح محتوى غرض (a56‏ أو عملية دمج محتويات أكثر من 
غرض 2)45 (: 
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Merge 


الوصف 


وذلك بتفريغ جميع تقوم بإزالة جميع البيانات المخزنة في الغرض 
تكون عملية تدمير الغرض وإعادة إنشاؤه أكثر فعاليةء الجدوال التي تحتويها. 
في بعض الأحيان) إلا في حال الرغبة بالمحافظة على مؤشر لهذا العنصر. 
مع محتوى غرض 1٥5ه4([تقوم‏ هذه الطريقة بدمج محتوى غرض 
يحتوي جميع البيانات من كلا ٤a56)ةD‏ آخر ق غرض ع5a)a5‏ 


الغرضين. 


طرق 86اه( الخاصة بالتعامل مع :×M1‏ 


ذكرنا سابقاً التنسيق التلقائي الذي تعتمده .N٤1‏ هو تنسيق 1× عند تخزين البيانات. لذلك يقدم الغرض 


.×١۷ا مجموعة من الطرق لقراءة وكتابة بيانات من وإلى وثائق‎ t€ 


الطريقة 
ReadXml‏ 


ReadXmlSchem 


a 
GetXml 


و 


GetXmlSchema 


WriteXml 


و 


WriteXmlSchem 


تقوم أغراض ع0415 مع أغراض ء1طه41اه التي تحتويها بالاحتفاظ بسجل عن قيم محتوياتها عند 


الضف 
وتأهيل 1× أو هيكل ا1 تقوم بقراءة معلومات وثيقة 
بها .)2)25 0غرض 
الذي ]۷× أو هيكل ا۷1 ×تعيد سلسة محرفية تحتوي وثيقة 
.مئل البيانات في غرض 


الذي يمثل البيانات ۷× أو هيكل تقوم بكتابة وثيقة 


إلى ملف على القرص أو غرض 4456 [ضمن غرض 
Reader/Writer‏ 


إنشاءها أو تحميلها إذ يعتبر هذا الأمر مطلب أساسي مهم للسماح بتثبيت التغيرات في مخزن البيانات الرئيسي 
وبالأخص في بيئة متعددة المستخدمين. 
مثال : 
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AS SEEMS SEMAN 1 EHROM BEOGUE ES J 


Dim COonnNSLE AS SITING = "Provider =VEPOLEDB.1l;Data Source=” & 
ACE (OAM LTE DATA TESTA „ DEC 


E 1 SO 


Oele 4S MNE OLEDIODElt eAelelokl êle (SEE SOL, COMMS I) 


New DataSet () 
DataRow 


CE; WEEOQMUCE LALE OW 


ds As 
dr As 


ا 


DEM 
Dim 
Dim 
1 


oda 
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OIE BAC CE UM CE. TELES (EEOC LIME) ROMS 
1SLDEemo. ILEMS .AOG(OE (TPEOO_ Name") .TOSLEING) 
NEXE GEG 


1 WeaRE EO OME A WAS OWS BHOEM GEMA ELS ERS CASS 
dgdlemo. DalaSource = Js. Tables (TProOduUcCEInEo") 


أغراض ۸20.١.٤‏ الأساسية 
يقدم الغرض 45٥1‏ أربعة طرائق لإعطاء قدرة أكبر على التحكم في كيفية ولحظة تثبيت البيانات: 


AcceptChan‏ تقوم بإتمام وتثبيت جميع التغييرات الحاصلة على الجداول والعلاقات 
٤ ٤ es‏ . 

منذ أن تم تحميلها او منذ اخر مرة تم تتفيذ 3)4561[ضمن غرض 

فيها . Accept han ges‏ الطريقة 


GetChanges‏ يحتوي بعض أو كل التغيرات التي 4456٤‏ تعيد هذه الطريقة غرض 
تمت منذ تم تحميل الغرض أو منذ آخر مرة تم فيها تنفيذ الطريقة 

AcceptChanges. 
تحدد فيما إذا تمت أي تعديلات على البيانات منذ تحميل الغرض أو منذ‎ HasChange 


S 
آخر مرة تم تنفيذ الطريقة‎ A cءءما‎ ٣121265. فيا‎ 


RejectChan‏ تقوم بإهمال جميع التعديلات التي تمت على القيم في الجداول ضمن 
کک منذ تحميل الغرض أو منذ آخر مرة تم تنفيذ الطريقة 456٤‏ [غرض 
فيها. تعيد هذه الطريقة المعلومات إلى الوضع AcceptChanges‏ 
الأصلي وتزيل جميع المعلومات المخزنة عن التغييرات. 


الغرض عء[طa‏ 1 :Da)a‏ 
يمكن الوصول إلى الجداول المحتواة في غرض 1ء045 عن طريق الغرض عء1ط04412› كل غرض 
eاab Data‏ يمتلك خاصة تسمى R0 ws‏ توشر إلى غرض DataRowCol]lect10¬‏ 


و هو عبارة عن مجموعة أغراض 0W‏ #۸Rه)ه5.‏ 


الطرق الأساسية لأغراض ءااة1هa)ة5:‏ 
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يوفر الغرض ء1ط12ه4 مجموعة من الخصائص والطرق التي تسمح بالتعامل مع كل جدول من جداول 
غرض ٥1)8٥‏ على حدى. من أكثر الطرق اکتا هي الطرa g AcceptChanges gy Clear‏ 
ئْعٍhan€Regect‏ وهي مطابقة لتلك التي يدعمها الغرض ٥)56‏ إلا أنها تطبق فقط على جدول 
وحيد هو الجدول الذي يؤشر إليه الغرض عاطاه٣هاة5.‏ كما أن هناك مجموعة من الطرق الأخرى التي 


تسمح بالتعامل مع محتويات الجدول وهي: 


NewRow‏ تقوم بإنشاء صف في الجدول.حيث يتم إدخال القيم إلى الصف باستخدام 
النص البرمجي . 
Select‏ تقوم بإعادة مجموعة من الأسطر التي تطابق تعبير تصفية معين. 


مثال: 


<%5@ Page Language="vb" %> 

<%5@ import Namespace="System.Data" %> 

<%5@8 import Namespace="System.Data.OleDb" %> 
<script runat="server"> 


Sub Page_lLoad(sender As Object, e As EventArgs) 
"declarations 

Dim mycon As OleDbConnection 

mMyEmMG AS OleDDCommand 

Dim mydap As OleDbDataAdapter 

mydst As DataSet 


MEO = New OLEDMICOMAEECE LOAM 
OE O LOSTESMLEEOSOEE OEE . OLEDS. 4A. OFFS && 
Dele! SOUECEE=GE E MTZDS. Elo) 


mydap = New OleDbDataAdapter ( _ 
"Select Coll, coll from myTable, 

mycon) 

mydst = New Dataset () 
MyYCapb.FILI(MYOSL, COLT) 

MG E EA DAE aA SOUECE — MuUCOSE. lal eS ( CEOLZ LL) 
MyGOEIC.DalaBINCd 


EEN SUS 


CJ ECEILOLS 

SEM 

<head> 

CELE LE>US ALAC DALAMAIEEE = 1M AOL MECS/ELLLES 
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Mead 


loocly Oe eo LOE = HEEE EEE = VOUOOOOUS 

<asp:DataGrid id="mygrid™ 

FONE =Neme= Ar laALY FOL -Size=N1OSEYS BackCOLEOE= NW CCCCECE SY 
MACE AHO Eee =YOY Cel lpaddi neq= 

rUnal='server" AuiOGEeNeralteColumns="False'z 

HORACE SEVLS EOE OOLE=YTEUEY EOC ZOACALANL LEA EON EEE 3S 
Ce OMRASS 

GEASS £ BOUNCCOLUA Daltalliele=Yeel1# Header Text =leol1Y £> 
GES ° BOUANCCOLUAS Dalal le lEO=YeegLZ2Y Header Text = lEeEol2 #2 
2 

</Columns> 

</asp:DataGrid> 


€ / OMS 
€CJMEMLS 


أغراض ۸20.١.٤‏ الأساسية 


الطرق الأساسية لغرض :Data RowColIIection‏ 
يمتل هذا الغرض كما ذكرنا مجموعة من الصفوف ضمن غرض ء1ط2 4)21( تم تحديدها بالخاصة R0۷Ws‏ 


لهذا الغرض. 


يوفر غرض ١0:ا‏ ء٥11٥٣ 0W‏ ۸ا04 مجموعة من الطرق لإضافة أو إزالة صفوف و لإيجاد صف بناء 
)€0nstt01(‏ على قيمة المفتاح الأساسي للجدول. 


الطريقة 


Remove 


Remove 
At 
Find 


الوضقف 
تقوم هذه الطريقة بإضافة سجل جديد تم إنشاؤه بالطريقة NewRow‏ 
(الخاص بء1طاة1ه)ة0) إلى الجدول . 

تقوم بإزالة أغراض 0W‏ 8ه( المحددة من الجدول 

تقوم بإزالة سطر محدد بقيمة دليل موقعه في الجدول 

تقوم هذه الطريق بأخذ مصفوفة من قيم المفتاح الرئيسي وتعيد الصفوف 
المقابلة لها في الجدول كأغراض 0W‏ 544۸8. 


الطرق الأساسية لغرض :5a)4 ۸0W‏ 
هذا الغرض يمتل الصف بحد ذاته ضمن الجدول وضمن الغرض ١0٥10اءء1[اه٣ 0w‏ ۸Rهاه2.‏ يمتلك هذا 
الغرض طرق كع ع١٣‏ 2ط٣1مءءAc‏ و Reject Changes‏ والتي تقوم بنفس العمل الذي تقوم به مثيلاتها في 
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رض ۹616 1ا0 افا لے هه لطر ك ها القرض مجر عة من الطرق المد الال مع 


الطريقة 
BeginEdit,‏ 
EndEdit,‏ 
CancelEdit‏ 
Delete‏ 


GetChildsRows 


SetColumnError 
yGetColumnsInEr 
ror 


مثال: 


الوصف 
تستخدم لتحويل الصف إلى وضعية التحرير وحفظ أو إلغاء 
التغييرات على البيانات في وضع التحرير. 
تقوم بتمييز الصف كصف محذوف» ولكن لن تتم إزالته من 
الجدول لحين تنفيذ الطريقة .Update ڃİ AcceptChanges‏ 
تقوم هذه الطريقة بإعادة مجموعة من الصفوف من جدول 
کو الضف عة ان 
تستخدم لتعيين وإعادة حالة الخطاً لهذا الصف. 
حیث تستخدم هذه الطرق مع الخصائص 12۴٤۲۲٥۲8‏ و 
#0۲ ۸ لتحري أو لتحديد أماكن الخطأ. 


يقوم هذا المثال تقوم باستخدام الطريقة ۴٣١‏ لإيجاد صف يحتوي قيمة محددة ثم يقوم بحذقه. 


:5a)4 ۷1ew الغرض‎ 


DataTable) 


' Test lo S66 IF the collection contains Ehe value. 
If rowCollection.Contains (TextBox1.Text) Then 
Dim foundRow As DataRow = rowCollection.Find (TextBox1.Text) 
rowCollection. Remove (foundRow) 

Console.WriteLine ("Row Deleted") 


CONSOLE WELLES (UNE SUE OW EOELUACl 


أغراض ۸2(0.N٤1‏ الأساسية 


Private Sub RemoveFoundRow (ByVal table As 
Dim rowCollection As DataRowCollection = table.Rows 


EMO SUIS 


Else 


HE E 


کا دزا مشت کا تاس غرض ۷ء3۷1( من خلال جدول في غرض .1()5٥1‏ يقوم الغرض 


Vie‏ 8ط بالتعامل مع جدول أو مجموعة من الصفوف في جدول. يمكن إنشاءه باستخدام الغرض 


fut View‏ الخاص بالجدول أو من خلال الغرض م1ط54114 الذي يقوم باختيار مجموعة جزئية من 


الصفوف في الجدول. 
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الطرق الرئيسية للغرض wWء۷1ه)5a:‏ 
بصورة عامة إن أفضل طريقة للتعامل مع محتويات الجدول ضمن الغرض 04861 هي إنشاء غرض 
t2i‏ من الجدول المراد استخدامه ثم استعمال الطرق التي يوفرها: 


الطريقة الا 
AddNe‏ . يمكن بعدها Wء414۷1(تقوم‏ هذه الطريقة بإضافة صف جديد إلى الغرض 
W‏ استخدام النص البرمجي لإدراج قيم في هذا الصف. 
t4 View. Delete‏ تقوم هذه الطريقة بإزالة الصف محدد من الغرض 
`Find‏ تأخذ هذه الطريقة كمعامل قيمة وحيدة أو مصفوفة من القيم وتعيد الدليل 


للصف الذي يطابق هذه القيم. 
FindR‏ 
OWS‏ 


تأخذ قيمة وحيدة أو مصفوفة من القيم وتعيد مجموعة من الأغراض 


التي تطابق هذه القيم. ٥a۸ 0W‏ 


مثال: 


DIM SLEESOD AS Sli = SBLECT * FROM EPEOCUCES 
Dim sda As New SqlDataAdapter (strSQL, connStr) 
Dim ds As New DataSet () 


SOE EL LL KECE, EEOQAUEE LAO) 


DIM dv AS New DaEaVi eM (AS. IaAOleES( Er OCUCGEIANE OL) ) 


Gwe. SOEL = #BrEOC Nem ASCZ 


CW. ROWE MLE E ك‎ #IM SLCOECK 3 LOOL 


° Bina the UataGtld to LhIS UaltaVvievw. 
Me.dgdDemo.DataSource = dv 


أغراض ۸20.٤1‏ الأساسية 
الأغرض :Data Reader‏ 
توفر أغراض 256 أرضية مناسبة للوصول إلى البيانات في بيئة غير متصلةء ولكن في الكثير من 
الحالات» وبالأخص في تلك التي نحتاج فيها إلى طريقة سريعة وفعالة للوصول إلى البيانات بدون الاضطرار 
إلى سحب جميع البيانات. 
يعد استخدام الغرض ١ءل2٠۸هه0‏ من أنجع الحلول لتحقيق: 
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٠‏ سحب سجل أو أكثر أو سحب قيم من حقول محددة 

؛DELETE‘UPDATE‎ «INSERT SQL تٽlرıبعت‎ ذıii‎ ® 

٠‏ عندما يكون لدينا فيها كمية كبيرة من البيانات أكبر من أن تتسع لها أغراض ع5448 
٠‏ ربط عناصر التحكم من جهة المخدم 


هناك نوعان أساسيان من الغرض e1‏ 24ء 4Rا5a:‏ 

OLE-DB eدختuڍ وهو‎ OleDbDataReader الغرض‎ 

SQاS۴‎ ۷٥۲ الغرض ١ء 2٥۸د5412 الذي يستخدم خدمات البيانات الجدولية الخاصة بمخدم‎ ٠ 
أو تخزين إجرائيات مخزنة لاستحضار مجموعة من‎ 5Q1 بتنفيذ تعليمة‎ 4)8۸ ٠44٥١ يقوم الغرض‎ 
صفوف البيانات والتجوال فيما بينها إذ تتم المحافظة على الاتصال مع مخزن البيانات في ذلك الوقت‎ 

٠‏ يوفر الغرض ١ء‏ 40ء ۸ه( شبيه للمؤشرات المستخدمة مع مخازن البيانات والتي تستخدم تعبيرات 
1 أو الإجرائيات المخزنة لاستخلاص مجموعة الصفوف 

٠‏ يوفر الغرض (41۸٥4٥١‏ إمكانية تنفيذ تعليمات 591 أو إجرائيات مخزنة لتحديث البيانات 

و يفا ركن ورل کر و ى ات 

الوصول إلى مجموعة الصفوف التي يشير إليها الغرض ١٤21ء‏ ۸ه)ة0 هووصول مخصص للقراءة فقط 
وباتجاه واحد 


DataReader ExecuteReader Command 


SELECT Statement : 
| Data Rows Connection 


Parameters Collection 
INSERT Statement [E 
ڪڪ‎ Parameter 
UPDATE Statemênt 
1 
DELETE Statement 
ExêcuteNöonQuêry 


ADO.NET أغراض‎ 


الطرق الأساسية للغرض ١ء‏ 4ء R‏ ۾)Da:‏ 
لاستخدام غرض 541382461 نقوم بإنشاء غرض ٥01214‏ ثم نستخدمه لتنفیذ تعبیرات 5Q1‏ أو 
إجرائيات مخزنة وإعادة غرض 1ء 2ء .0a)R‏ 

يمكننا بعدها الدوران عبر هذه الصفوف والأعمدة باستخدام الغرض (18۸٥44٥١‏ لاستخلاص النتائج من 
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مخزن البيانات. 


أكثر طرق الغرض DataReader‏ استخداما هي التالية: 
الطريقة الوصف 
0 ۴ | يقوم بدفع مؤشر الصف خطوة إلى الأمام ليؤشر إلى السطر التالي بحيث يتم 
الوصول إلى قيم الأعمدة باستخدام اسم العمود أو رقم التسلسل الخاص به. 
1 | تعيد قيمة من الصف الحالي بنفس التنسيق المُستخدم في مصدر البيانات 
رتك شید ن لم فة عة بتكن اط وگن كر فة كن 
استخدام اسم العمود مباشرة وذلك بالشكل . 
Value=DataReader(‘col-Name’”)‏ 


٠ 1‏ يقوم باعادة قيمة أو مجموعة قيم من الصف الحالي بتنسيقها الأصلي وذلك 
ues‏ 


×××68 _ تقوم بإعادة قيمة من السطر الحالي بتنسيق نمط البيانات المحدد حسب 
XXX‏ 


الطريقة ×>>>×>×>××. 

GetBoolean,GetInt16,GetChars. Jia 

NextRe‏ تقوم هذه الطريقة بنقل مؤشر الصف إلى مجموعة الصفوف الأخرى عندما 
| تقوم تعليمة 801 أو الإجرائية المخزنة بإعادة أكثر من مجموعة صفوف. 

تجدر الإشارة إلى أن هذه الطريقة ليست مشابهة للطريقة )× M0۷٥‏ لأنها 

لاتنتقل ضمن نفس مجمو عة الصفوف بل من مجموعة صفوف إلى أخرى. 

86 _ تقوم بإغلاق الغرض ١ء44‏ 14۸ة(وتحرير المؤشر الذي يشير إلى 


E 


أغراض ADO.NET‏ 
متی یجب استخدام غرض ۲ء0 ٥4)۸4‏ ومتی یجب استخدام غرض 4)45 5: 


عن البدء بيتاء تطبيقاتا لوصول إلى مخازن افيانات: يجب عليتا أن تفكر بتوع الوصول الذي ذريذ وكيف 
سيتم استعمال البيانات. 
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لا بد وأنه أصبح من الواضح مما ذكرناه مسبقا أن أغراض 041886 تسبب حمل وتعقيد لا يمكن إهماله 
مقارنة مع الغرض 01۸٠44٥١‏ من حيث الأداء واستهلاك الذاكرة. إذاأً لابد لنا من التركيز على استخدام 
الغرض 0a†4R 4er‏ عوضا عن 56هاة2. إلا أن هناك بعض الحالات التي لا يمكن فيها الاستغناء عن 
€ وهي: 

٠‏ عند حاجتنا إلى استخدام البيانات بشكل غير متصل مع مخزن البيانات وتمرير هذه البيانات إلى أطر 
أخرى ضمن التطبيق» وتخزينها » وتحريرها 

٠‏ عند الحاجة إلى تخزين» ونقل»ء والوصول إلى أكثر من جدول (أكثر من غرض ءاطة0421) ومعالجة 
العلاقات بين هذه الجذارل 

٠‏ عند الحاجة إلى تحديث البيانات في قاعدة البيانات باستخدام طرق خاصة بغرض 45ا04 و 
Dat Adapter‏ عوضا عن استخدام تعبیرات 0۶5۸1۴ 591 أو استخدام الإجرائيات المخزنة 

٠‏ عند الحاجة لإدارة الوضع بشكل أفضل في بيئة متعددة المستخدمين 

٠‏ عندما نريد الاستفادة من المزامنة بين وثائق ]۷× ومجموعة الصفوف العلائقية المقابلة 

٠‏ في بعض حالات الربط مع عناصر التحكم مثل حالات الربط مع أكثر من عنصر في نفس الوقت» أو 
تقسيم السجلات إلى صفحات في عنصر تحكم ل6۲1ه)4(. إذ نستخدم في هذه الحالة الغرض سwء۷1‏ 4)4 
المنشأً من جدول في غرض اع545 

٠‏ في حال أردنا الدوران ضمن صفوف البيانات وأردنا الحصول على حرية في اتجاه الحركة للأمام أو 
الكلت. ها اكا لا يمكننا استخدام الغرض Data Reader‏ 


SqlConnection conn = new SqlConnection(connectionString); 

SqlCommand comm = new SqlCommand("select * from mytable", conn); 

comm.Connection.Open(); 

SqlDataReader r = 
comm.ExecuteReader(CommandBehavior.CloseConnection); 

while(r.Read()) 
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| Console. WriteLine(r.GetString(0)); | 
} 
r.Close(); 
conn.Close() 


مزودات البيانات العلائقية في .N٤1‏ 


كما رأینا سابقاً تستخدم .N۴1‏ مزودات بیانات للاتصال بمخازن البيانات . يوفر إطار عمل .N٤‏ دعم 
لمجموعة المزودات التالية: 


دوزم0اLE-DB‎ JÛ SQLServer SQLOLEDB 
دوزم0اLE-DB‎ J ORACLE MSDAORA 
Microsoft.Jet.OLEDB.4.0 


مصادر Access‏ ل D08-Eا0مزود‏ 
٤ه[البيانات‏ التي تستخدم مزود 


تقدم .N٤1‏ أيضاً المزود 028٤٣‏ الذي تم تطويره ليسمح بالاتصال بالعديد من التجهيزات ومخازن البياناتء 
وهو يستخدم أغراض مشابهة لتلك المستخدمة مع المزودات الأخرى فهو يتضمن ملأ «OdbcConnection‏ 
.ël}...OdbcDataAdapter «OdbcDataReader «OdbcCommand‏ 


أمثلة 


OleDbCon nection ضرغئll مثال استخدام‎ 


<%5@ Import Namespace="System.Data.OleDb" %> 
<script runat="server"> 
sub Page_Load 


Gl Cloe OMIA 
COCOA = NOW OLEDOICOMNECE LOR (YEEOVLOAEE IML CEOSOE E JEKE . OLED. 4A OF 


dala soUurce=" & SEFVEErE .Mappalth(Tnofrthwlind.maAb"™})) 
dbconn. Open () 

end sub 

J SCCLOLS 


مثال استخدام الغرض C٣0٥١ ٣2۸4‏ 


| <%@ Import Namespace="System.Data.OleDb" $%> 
<script runat="server"> 


sub Page_Load 
CIM CUDCONRN, SOL, UDGCOMN 
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CIOCORMN= NEW OLEDOCONNECE LON (HY EEOVLAEE ML CEOSOE E . JEKE , OLED 4 „OF 
data source=" & Server .mappath ("northwind.mab™)}) ) 

dbconn. Open () 

Sql="SELECT * FROM customers" 

GObEomm=New OleDbCommand (Sql, dbEeonn) 

end sub 

GJOECELOLS 


مثال استخدام الغرض Data Reader‏ 


<%5@ Import Namespace="System.Data.OleDb" %> 
<script runat="server"> 

sub Page_Load 

Jim CbEonNnN, SL, ObEOMN, CUDEEAG 

CHOCO NEY OLEDIOCOMAECIE LON (WBE OWA ML. CEOSOE E o. JOE , OLED. #4 OF 
data SouUurce=" & Server .mappalth{("northwind.mOb™) ) 
dbconn. Open () 

SGqI="SELECT = BHROM Cust Omer Sl 

dbeomm=New OleDbCommand (sql, dbEeonn ) 
dbread=dbcomm. ExecuteReader () 

end sub 

GJ SCELOLS 


DataView gy DataAdapter و‎ Da(a5e( مثال استخدام غرض‎ 


<$@GPage Language="VB" $> 


Import Namespace="System.Data" %> 


Import Namespace="System.Data.OleDb" %> 


@ @ 


€ DOCTESES BTML, UBLLE =7 WIC /DID MOM 2.0 TEANSLELONAL/ ENS 
<html><head> 
<title>The .NET DataSet and OleDbDataAdapter Objects</title> 
l= ime luEdê E1 le= o OLO SEVLE AMEY ==> 

</head> 

IOOCY Oo CEOLOE— HE E le E > 

<span class="heading">The .NET DataSet and OleDbDataAdapter 
Objects</span><hr /> 


GEA VE>COANNECE LON SEELAMGE SOSA LEO HOLE CONNEC E 
UREA lSEEVEB L> SPARE GO O 

<AIV>SELECT command: <b=<span 10="outSelect" 
EUNEIE= YY SECVECYS</ SOARNESA OS CALS 

€EAiw 1E WOUEELEOEY CUNE = SEC TUOC VSEMOSOE SOLS 


ASO FOACACELE LE=HEEERESULEY EURaAE= Server /> 


<SEFIpt language="vb" runat="server"> 


Universal Knowledge Solutions s.a.1 192 


OUERAKE TOE . LRNEE MM = U<oz* ACEO WALLS ACCESSING Calta OE .<OE ASW 
& OI JEK KOK MESSAGE & <O EF" & OOJEEEOK „ SOU CE 

EXILE SUD " and SOD CExecGULIonN 

End Iry 
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SUb Page_Load() 


'get connection string from web.config file 

DIM SEEECEONREE E AS SEER 

SIErCONNECL = CONEIGUFALIONSELLCINGS.AppSELLINGgS ("DsnWroxBookKsJel") 
& Request.PhysicalApplicationPath _ 

& "databases\WroxBooks.mdb" 

outConnect.innerText = strConnect 'and display it 


"specify the SELECT statement to extract the data 

Dim strSelect As String 

SILrSElLECGE = "SELECT * FROM BookLISL WHERE ISBN LIKE O64 
outSelect.innerText = strSelect aNd @ALEOLE AC 


"declare a variable to hold a DataSet object 

"nol Thal We have Ll0o Greate Ill GOULSIIs the TEV. .Calch Block 
'as this 1s a separate block and s0 ls a different Scope 
Dim objDataSet As New DataSet () 


WE 


'create a new Connection object using the connection string 
Dim objConnect As New OleDbConnection (strConnect) 


'create a new DataAdapter using the connection object and select 
SEE EEE 
Dim objDataAdapter As New OleDbDataAdapter (strSelect, objConnect) 


'"fIll the dataset with data from the DataAdapter Object 
objDataAdapter.Fill (ob jJDataSet, "Books") 


Catch ob]JError As Exception 


IMS OLAY CEES dela NIS 


'create a DataView object for the Books table in the DataSet 
Dim objDataView As New DataView (ob jJDataSet. Tables ("Books") ) 


"assign the Dataview object to the DataGrid Control 


dgrResult.DataSource = objDataView 
dGERESULE.DalaB1nd() "and bind (display) the data 
BMC SUS 

A SEE 
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<!-- #include file="..\global\foot.inc" ==> 
€ / OMS 
€ MEMLS 


:DataRow gy DataColumn ڪ‎ DataTable gy DataSet مثال استخدام‎ 


Dim ds As New DataSet () 


DIM SIETSOL As SILING = SELECT CUSE ID, Oriert IO, °" & 
OEE Deatê EROM OEdeîe sS WHERE Xele (OFC Data) >» LITT 
Dim oda As New OleDbDataAdapter (strSQL, connStr) 

OCE . ELLA (QAS, OEE LEO) 


SIE SO ZZ NS RINE ON CUSEOMSEE ND EROM COUSEOMeERS ESE 
ORDER B4 CUS OMEN 1Y 

Dim sda As New SqlDataAdapter (strSQL, connStr) 
sda.Fill (ds, "CustomerInfo") 


DIM CEL AS Del COLUMN — _ 

ds.Tables ("CustomerInfo") .Columns ("CustomerId") 
DIM CEA AS DAlCACOLMMN = _ 

ds.Tables ("OrderInfo") .Columns ("Cust_Id") 


Dim dr As New DataRelation ("CustomersToOrders", dcl, dc2) 
CS. RENAE LOME ,. ACE (OIE) 


Dim drCustomer As DataRow 
Dim drOrder As DataRow 


For Each drCustomer In ds.Tables ("Customer Info") .Rows 
lstDemo. Items.Add("Customer: " & _ 

OEFCUSEOMGT (TCUSEOMETTIOT J. ToOSIETING()) 

' Iterate through related rows. 

For Each GFOrderT IN OQrCUSEOMET.COEECHILOROWS (OE) 
1lstDemo. Items.Add( _ 

SEE LAC, ROEMEAE (8 OEE ON placed OM O, 

GIEOEElErE (OEE DY, CEOEECleE (HOE Dale) J) 

Next drOrder 

Next drCustomer 


مقدمة عن XM‏ في .NE†‏ 


تكلمنا سابقاً عن المزايا الجديدة في إطار العمل .N8١‏ والمخصصة للوصول إلى البيانات العلائقية وقمنا 
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أصبحت لغة ۷1× وبسرعة» اللغة الأساسية على الوب وتم اعتمادها من قبل العديد من التطبيقات. لذا 
سنركز في هذا الجزء على الطريقة التي تدعم بها .N۴٤۲‏ لغة XML‏ 


أغراض ۷1× الأساسية في :.:NE1‏ 

قدمت منظمة ۷3٥0‏ مجموعة من المعايير التي حددت البنية والواجهات التي يجب تزويد التطبيقات بها 
للوصول إلى وثائق ا۷×. تسمى هذه المعايير ب .)00M(‏ وقد تبنت آ٤N.‏ دعم هذه النعايير من خلال 
الأغر lض .XmIDataDocument gy XmlDocument‏ 


توفر هذه الأغراض دعما كاملا لمعايير 1× )0(0M(‏ من الدرجة الثانية. 


XMLDocument and XMLDataDocument xmlFlement 


Aml Attribute 
آ‎ XML Node Object Types 


| XmlComrment 


W3C XML DOM Level 2Z Core 


تقديم إلى XML‏ في .NET‏ 


وسعت .N ٤1‏ دعمها ل[ ۷1× عبر تقدیم تقنيات للتعامل مع وثائق ۷1× وھیاکل ۷1× وملفات 
الأنماط . فيما يلي مخطط يوضح الأغراض التي نستخدمها للتعامل مع وثائق :×١M1‏ 
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Read and Write XML 
System. lO. TextWritêr 


Systern.lO. Stream 


XSLT 
Stylesheet #HmlTextReadeêr HmlNodeReader 


تتوز ع أغراض ۷1× الأساسية في ثلاث مجموعات: 

٠‏ الأولى لقراءة وكتابة وتحويل ملفات ۷1× وتتضمن هذه المجموعة أغراض e×)R e41‏ 1۲× و 
Xml TextWriter‏ و Xml|NodeReader‏ إضافة إلى غرض ٤٥۲۳‏ ء٣11۲ء‏ الخاص بإنشاء ملف 
بتنسيق مختلف عن وثيقة ۷1× الأصلية. 

»>ص100cu‎ ع٣٤ الثانية خاصة بتخزين وثائق ۷1× والتعامل معها وهي تتضمن الأغر اض مثل‎ ٠ 
.XPathDocument «XmlDataDocument 

.XPathNavigator أما الثالثة فهي خاصة باستعلام ۷1× ونستخدم فيها الغرض‎ ٠ 

بالطبع سنلاحظ تداخل بين هذه الوظائف. فلاختبار وثيقة 11× أثناء قراءتهاء نستخدم الغرض 
idatingReaderاXm1Va‏ وهناك أغراض أخرى لإنشاء وتحرير هياكل ومخططات [۷>. كما يمكننا 
أيضاً استخدام الغرض ١٣0۲٤ء«هةإ11ء×‏ لتتفيذ استعلام على وثيقة بالإضافة إلى تحويلها إلى تنسيق مختلف. 


Document أغراض‎ 


لدينا ثلاث آليات تطبيقية لغرض )1ع :[50٥c10‏ 
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٠‏ الغرض ,عص uء1(00ص×:‏ وهو عبارة عن آلية تطبيق .٥۲‏ لمعاییر .50٥۳0‏ تتضمن خصائص 
وطرق هذا الغرض تلك المعرفة من قبل ۷3٣‏ للتعامل مع وثائق ]۷1× مع بعض الإضافات لجعل 
العمليات الأساسية أسهل. 


٠‏ الغرض ٤1عدm1(0ata(0cun>×:‏ هو عبارة عن امتداد للغرض ٤٣عہں0cu ×1٥‏ یوفر نفس 
مجر عة الخضاض و الطرق» كا يعمل كج وضلا ن .5 وطر اق قر اعد البادات العلاقة: 


٠‏ الغرض ا«عصuء0‏ ط۴× يمتل آلية سريعة لتخزين وثائق ]۷× وهو مصمم ا لیتم 
الوصول إليه باستخدام الغرض ١0ع XPath Nav1‏ باستعمال استعلامات ط۴× فقط أو الملاحة ضمن 
الوثيقة عنصر تلو الآخر باستخدام تقنية ”1إں۲“. 


الطرق الأساسية لأغراض رع :050cu‏ 


لا يمتلك الغرض ١ع 0u‏ (٥1ط)ة۴×>‏ طرق عامة ذات فائدة غير الطريقة 0۲ةعN2۷1ع)ةع€۲‏ كونه مصمم 
ليعمل فقط مع الغرض ١0ه2ع¡۷هN[طاه۴×.‏ في حين يوفر النوعان الآخران لغرض ١ع۳ (0٥1‏ مجموعة 
كاملة من الطرق والخصائص وهي تلك المحددة في معايير .۷3٣٤ (0M‏ إضافة لما ذكر يوفر هذان 
النوعان مجموعة مفيدة من الطرق والخصائص التي تستخدم بشكل كبير للعمل مع وثائق 1× وهي 


تتضمن طرق لإنشاء أنواع معينة من العقد والوصول إلى عقد موجودة. 


الطريقة الوصف 
×××××1848© | تقوم بإنشاء عقدة في وثيقة 1× اعتمادا على اسم الطريقةء مثل 


x 
«CreateComment «<CreateElement 


خl!...CreateTextNode‎ 


CloneNode‏ تقوم بإنشاء نسخة مثيلة عن عقدة ۷1× متل نسخة من عقدة 
Element‏ 
GetElementB‏ تقوم بإعادة عقدة وحيدة باستخدام قيمة الواصفة 17 كمعامل. 
yId‏ 
6 ۴ ۴ ۴ / تقوم بإعادة عقدة وحيدة باستخدام اسم التأشيرة كمعامل 
ByTagname‏ 


ات لض رعا من الطرق اتل حفط ۷ من و لى ركن د N‏ 
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Save‏ تقوم بحفظ وثيقة XM‏ كاملة إلى ملف على القرص أو إلى غرض ٣4ء1‏ أو 
إلىغرض .XmI Text Writer‏ 

0۵ تقوم بتحميل عقدة من وثيقة 1× يجري التأشير إليها بغرض 
.XmINodeReader ضرغè yİ XmlTextReader‏ 

6 تقوم بكتابة عقدة إلى وثيقة 11× يجري التأشير إليها بغرض 
XmlTextWriter‏ 

6 تقوم بكتابة عقدة وكل ما يندرج تحتها إلى وثيقة ۷1× أخرى يجري التأشير 
Cont‏ إليها بغرض ع)e×)W1‏ 01'۲ .X‏ 


الطرق الأساسية لأغراض ٤١ء‏ uء٥0(‏ (متابعة) 


أما إذا أردنا استعمال الغرض ١0ةع۷1 [N2‏ ط۴× في وثيقتنا فإننا نقوم بإنشاءه باستخدام الطريقة 


:CreateNavigator 
الطريقة الوصف‎ 
تقوم بإنشاء وإعادة غرض ةع ۷1 ۴1× مبني على وثيقة‎ _ R801 


.ةيلاحلا×M[-‎ 

يمكن تطبيقه على جميع أنواع أغراض gag . Document‏ 
XmlDocument‏ و m1(ata2Document>تقبل‏ هذه الطريقة 
معامل إضافي يشكل مؤشر إلى عقدة في الوثيقة والتي ستكون 
موقع البداية ئلغرض XPath Navigator‏ 


يدعم غرض 1ع 1ا0٥0(ه)ة(1ص×‏ خاصة إضافية عن الخصائص يقدمها الغرض 1ع 1(00cuصہ×‏ : 
الخاصة الوصف 


.0a48ء تقوم بإعادة محتوى وثيقة 1× كغرض‎ DataSe 
t 
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كذلك يدعم الغرض ١ع‏ ٠٥a20)ة٥1_×‏ طريقتين إضافيتين توفران وصول أقوى إلى محتوى الوثيقة 
وذلك بالتعامل معها كمجموعة صفوف أو جدول بيانات. 


الطريقة 


GetRowFromElement 


GetElementFromRow 


t 


الوصف 


يمتل العناصر D۸ 0W‏ يعید غرض 


یمثل ٥۸٤‏ ٣إ٥[٤1ہ×‏ یعید غرض 


6ط في جدول ضمن a48 0W‏ 


XPathNavigator ائغرض‎ 


لجعل العمل مع وثائق ]۷× أسهل تم تعريف الغرض ١٥20ع‏ N2۷1[طاة۴×‏ في فضاء الأسماء 
System.‏ والذي يمكن استخدامه للتجوال ضمن وثيقة 1× أو للاستعلام عن مكون ضمن الوثيقة 


باستخدام تعبیر 1اa٣۴×‏ . 


نشير إلى أنه يمكننا استخدامه الغرض XPath Navigator‏ مع أي غرض وثيفة ۷1× ولیس فقط مع 
.XPathDocument‏ آي يمكننا إنشاء غرض 20۲عnN2v1طPat×‏ مبني على غرض XMLDocument‏ 


أو على غرض .XmIData Document‏ 


يقدم الغرض ١0٥20عN4۷1ط)ة۴×‏ مجموعة من الطرق والخصائص التي تسمح بالتجول ضمن وثيقة ×M1‏ 
كالانتقال بين العقد بالترتيب أو بتجاوز العقد حتى الوصول إلى عقدة من نمط معين. 


يقدم الغرض ١20عN2۷1طاة۴×‏ مجموعة من الطرق التي تقبل تعبیر ات ۴1× أو اسم العقدةء أونمط 
العقدةء وتعيد العقدة أو مجموعة العقد المطابقة. عندها نستطيع التجوال عبر هذه العقد. 


يمكن إنشاء الغرض ١20ع2۷1لN[طاة۴×‏ فقط من غرض وتيقة موجود وذلك كمايلي: 


objXMLDoc.CreateNavigator () 
objXMLDataDoc.CreateNavigator () 


Doc.CreateNavigator () 
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ObBIXPath 


Dim objNavl1 As XPathNavigator = 
Dim objNav2 As XPathNavigator = 
Dim objNav3 As XPathNavigator 
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الطرق الأساسية لئغرض XPathNavigator‏ 


يسمح هذا الغرض بالتجوال عبر الوثيقة واختيار عقدة ضمن وثيقة ۷1× والوصول إليها. يمكننا إنشاء أكثر 
من غرض من هذا النوع على نفس الوثيقة ومقارنة مواقعها. 
لتحرير وثيقة ۷1× نستخدم مؤشر إلى العقدة الحالية لهذا الغرض أو غرض ١0اهع)e1 N0‏ طا۴a×‏ الذي 
يحتوي أكثر من مجموعة من العقدء ونقوم باستدعاء الطرق الخاصة بعقدة ما من المجموعة. 

في نفس الوقت يوفر الغرض ١0هعN2۷1‏ ط۴× تفاصيل حول العقدة الحالية وبهذا يكون لدينا طريقتان 
للوصول إلى معلومات عقدة ما ضمن الوثيقة. 
فيما يلي جدول يوضح أكثر طرق الغرض ١0اةع۷ة‏ ط۴× استخداماً. هناك طرق للحركة ضمن الوثيقة 
لجعل عقدة ما هي العقدة الحالية بالنسبة لغرض rثXPathNavigat0‏ أو لإنشاء غرض XPath Navigator‏ 


جدید: 


الطريقة 


MoveToxxxxxx 


Clone 


يقوم بتحريك موقع الغرض ضمن وثيقة ]۷1 الحالية. لدينا 

MoveToFirst ,MoveToRoot ,MoveToAttribute, :n 
move ToParent, Move ToFirstChild.. 

إنشاء غرض ١0٥0دعN2۷1[طاة۴×‏ جديد متوضع في نفس المكان 
الذي يتوضع فيه غرض الحالي 0۲ا2 ع۷1 Na‏ ط)ة۴× ضمن الوثيفة. 


ارف 


اك يشا طرق مخسصة اللرصرل زاختار جز من مرن وة 


الطريقة 
GetAttribute‏ 
Select‏ 


SelectAncest 
OrS 


SelectDescen 
dants 


SelectChildre 
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لوضف 


تقوم بإعادة القيمة المحددة بالمعامل المحدد من العقدة الحالية للغرض. 


تعيد غرض ١40إء1ءلهN[طاه۴×‏ الذي يحتوي مجموعة من العقد 


التي تطابق التعبير طاa٣×.‏ 


تعيد هذه الطريقة غرض ١40ع)1ءلN0ط)ة۴×‏ الحاوي على 


معیين . 


تعيد غرض ١40ءع)1ءلN0طاجة۴×‏ يحتوي مجموعة من العقد 
المتحدرة من الوثيقة والتي لها نمط معين أواسم معين. 


تعيد غرض ١1)2۲40ءلN0طاجة۴×‏ يحتوي مجموعة من العقد 
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الأبناء من نمط معين أواسم معين 


XmlITextWri{er ضرغئl‎ 


عند استخدام الغرض ×.”1٥ 0٥٠٥١‏ لإنشاء وثيقة ۷1× جديدة يجب علينا إنشاء أجزاء وإدراجها ضمن 


الوثيقة بطريقة معينة» وهي طريقة قد تكون معقدة ومصدر للخطا. 

يمكن للغرض ١عاآ٣W‏ 1× أن يُستخدم لإنشاء وثيقة ×١1‏ عقدة تلو الأخرى بطريقة تسلسلية بكتابة 
التأشيرات والمحتوى إلى الخرج باستخدام مجموعة الطرق التي يقدمها هذا الغرض. 

يأخذ الغرض ۲ءا! ×1× كمصدر» إما غرض ١ءاإا‏ 1۴×۷ الذي يوشر إلى ملف على القرص »و 


مسار» واسم هذا الملف» أو غرض 5)٠”‏ الذي يحتوي وثيقة ×١1‏ جديدة . 

يقدم هذا الغرض مجموعة من الخصائص والطرق التي يمكن استخدامها لإنشاء عقد 1× ومحتويات 
أخرى» ثم يقوم بتوجيه الخرج إلى ملف على القرص أو غرض 5)٠4‏ بصورة مباشرة. 

٠‏ يمكن أن يتم تعيين الغرض ×_”1١١×W ۲:٤۴١‏ كأداة خرج لطرق في أغراض متعددة حيث يقوم غرض 
Xm] rextWriter‏ بتوجيه المحتوى إلى ملف على القرص أو غرض ١ء)1 ۲١×۷‏ أو غرض Stream‏ 


الطرق الأساسية لغرض ١ء٤آ٣W×١۶١1"×:‏ اكثر الطرق استخداماً لهذا الغرض هي التالية: 


الطريقة 
WriteStartDocument‏ 
WriteEndDocument‏ 


WriteStartElement 


WriteEndElement 


WriteElementStrin 8 


Close 
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الضف 
تقوم ببداً وثيقة جديدة وكتابة تصريح ۷1× إلى الخرج. 
تقوم بإنهاء الوثيقة بإغلاق جميع العناصر غير المغلقة ثم إرسال 
المحتوى إلى الخرج. 
تقوم بفتح تأشيرة لعنصر محدد. عندها يمكن البدء بإنشاء 
الواصفات باستخدام الÛطريةڌة WriteStartA ttri bute‏ 
تقوم بكتابة تأشيرة إغلاق للعنصر الحالي. الطريقة المقابلة 
لإغلاق واصفة هي .WriteEndA (tribute‏ 
تقوم بكتابة عنصر كامل (بما يتضمن تأشيرات الفتح والإغلاق) 
باستخدام سلسة محارف كقيمة. الطريقة المقابلة لأداء نفس العلم 
مع الواصفات هي .WriteAttributeS([11£‏ 
تقوم بإغلاق الملف على القرص أو غرض ٣۵۳٠5)۲وتحرر‏ 
جميع المؤشرات المرتبطة. 
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lنئغرض Xml1IReader‏ 
نحتاج في بعض الأحبان إلى قراءة وذائق 1× من مصدر آخر عوضا غن كتابتها: 


يعتبر الغرض ١٤2ء1۸"‏ × صف قاعدي يرٿ منه صفان عjlal XmlITextReader laa‏ و 
.XmINodeReader‏ 

٠‏ gيعتمد‏ الغرض ١ءلهaء ×1١ ١×۸‏ على الغرض ١ءلهء‏ 1۴×۸ الذي يؤشر إلى ملف ا۷١×‏ على 
القرص» وإلى مساره واسمه أوإلى غرض S۲۴۳١‏ يحتوي وثيقة -اM1×.‏ يمكن قراءة محتوى الوثيقة عقدة 
تلو الأخرى» ويوفر الغرض معلومات حول كل عقدة وحول القيمة التي تحتويها أثناء قراءتها. 

٠‏ يأخذ الغرض ل2 eRء1N0dصX‏ غرض ءل1N0ص×‏ كمصدر له مما يسمح بقراءة جزء من وثيقة 
× عوضاً عن قراءة كامل الوثيقة في حال كان هدفنا لوصول إلى عقدة معينة وإلى العقد الأبناء لهذه 
العقدة. 

٠‏ يمكن أن يُستخدم الغرضان X11 ex) eae‏ و Xm |NodeReader‏ بصورة منفصلة لتوفير 
وصول سريع وفعال لوثائق × أو كمصدر لأغراض أخرى حيث نقوم تلقائياً بقراءة الوثيقة و تمرير 
ناتج القراءة إلى الغرض الأب. 


تستخدم الأغراض t0rغNaviga XPath‏ و Xm]rextReader‏ نمذجة 117م“ للوصول إلى البيانات عقدة 
تلو الأخرى عوضا عن تفريغ كامل الوثيقة كشجرة ضمن الذاكرة. يسمح ذلك بالوصول إلى ملفات كبيرة 


الحجم دون استهلاك الكثير من الموارد ويجعل عملية كتابة النص البرمجي أسهل لإي أغلب الحالات. 


كما تبرز أهمية هذه الأغراض في الحالات التي نبحث فيها عن قيمة معينة عندها لن نضطر إلى قراءة كامل 
الوثيقة بل يمكننا الوصول إلى عقدة محددة بعد قراءة جزء من الوثيقة. 


الطرق الأساسية لغرض rءadءXmI1R‏ 


Universal Knowledge Solutions s.a.1 202 


يمتلك الغرضان X17 e×R ead‏ و XmNodeReader‏ خصائص وطرق متطابقة تقريباء هم الطرق 


المستخدمة هي: 
الطريقة الوصف 
Read‏ رم را اة التاة إلى القرضن حبك يكن الرصرل ها ته 


القيمة عءاه۴ عندما لا يتبقى أي عقد لقراءتها. 

ReadInnerX‏ تقوم بقراءة وإعادة محتوى العقدة بشكل سلسلة محارف بما فيها جميع 
التأشيرات والنصوص للعقد الأبناء. 

٥۲×‏ ا۸۵00 __ تقوم بقراءة وإعادة محتوى وتأشيرات العقدة الحالية كسلسلة محارف 
بما فيها جميع التأشيرات والنصوص للعقد الأبناء . 

ReadString‏ تقوم بإعادة سلسلة محارف تحتوي قيمة العقدة الحالية. 

ئ61 _ تقوم بإعادة قيمة الواصفة المحددة للعقدة الحالية لغرض 1ء X1۸4‏ 

6R 8۴4‏ تقوم بقراءة وإعادة الجزء الباقي من وثيقة ۷1× المصدرية كسلسلة 


o SME aS E a E 
إلى أخرى.‎ 
و‎ MoveToAttribute :Jlثûم‎ .ئراتll تقوم بنقل موقع مؤشر‎ MoveToxxx 
MoveToElement gy MoveToContent 
تقوم بتجاوز العقدة الحالية والتحرك إلى العقدة التالية.‎ Skip 
الذي يتم‎ 51۲62٠۳١ تقوم بإغلاق الملف على القرص أو إغلاق الغرض‎ Close 


التعامل معه. 


llغرض XMLValidating Reader‏ 
هناك غرض آخر مبني على الصف Xm1R ader‏ وو llغرض XmlIValidatingReader‏ . 
يمكننا النظر إلى هذا الغرض كغرض ١ءل4ع "1١١×۲۸8‏ × ولكن بمهمة نقييم وثيقة مقارنة بهيكل أو بمخطط 
ما. 
يمكننا إنشاء غرض Xml ValidatingReader‏ من غرض ۲ه 1۸× موجود» أو من غرض ٣۵۳ع۲)؟»‏ 
أو من سلسلة محارف تحتوي ۷× ليتم تقييمها والتحقق منها. 


اأغزرض :XsITransforı¬‏ 
تعتبر الحاجة إلى تحويل الوثيقة باستخدام 1؟× أو S11؟×‏ من أهم متطلبات العمل مع وثائق ا۷١×.‏ 
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تدم NE‏ الغرض ا٤و‏ اا المسمم خصیصا راء لیات التحریل باستخداہ S1‏ أو 
.XSTL‏ 


الطرق الأساسية لغرض :Xs1 ۲٣ھ ,٤f0٥ ٣‏ 
تقدم ۴0۲۳٤1۲۲۵ء×‏ طریقتین اساسیتین هما: 

الطريقة الوصف 

متيو×S1 تقوم بتحميل وثيقة أنماط‎ Load 
التأشير إلى أي وثيقة أنماط باستخدام‎ 
xsl:include 
× تقوم بتحويل بيانات وثيقة‎ Transform 


محددقباستخدام 81× أو 811 ×وتقوم 
بإخراج الناتج. 


مثال 


نلاحظ في هذا المثال أننا استخدمنا الغرض 6١1‏ uا٥00|"×‏ ثم قمنا بتحميل ملف إليه بالطريقة ١2٠ا‏ 
وبعدها قمنا باستخدام الطريقة ۳6 8۸8/۲29١2‏ 661۴|6۳ لإيجاد جميع العقد التي يكوناسم التأشيرة فيها 
ھو “Auther N2٥”‏ ثم قمنا بالدوران ضمن النتائج وإظهارها. 


<$@Page Language="VB" %> 
<$@GImport Namespace="System.XML" %> 


€ I DOC LES MIM PUSLLCE =7 AMICIIDID MOM 4.0 TEanellLional/ 7 ENS 
<html><head> 
CELELEZ SEK CMLME GOM ML COCUMEME USANE EME DOM<SJENLELGE 

<l Amel UGE E1 LEW. cC NOLOALNSE VLE; AMEY 3 

</head> 

GIOOCDY OoGCEOLOE= HE E E > 

<span class="heading">Ssearching an XML document using the 

DOME SOA E 

— ن ---- |> 


IIT LI=TOUCDOCURL" EUnaL="SerTEE <O 
GALT LO=VOUEEELOE" EURAE= SEKE VOR SERIE SALTS 
Chg OE NS Ga OG a Cg a O 


<scCEipt language="vb" runat="server"> 


Sub Page_Load() 
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'"ECEEate physical path to bookKlISE. xml Sample FIle (in Same folder 


4 O 


OU DOC UEL , LAADOErE HTML = WLOAMEM FILE, <OSU & SCOWMLDAEA & W/O 


as ASPX page) 
Dim SEECULCTEnNntPaLh As SILINnG = ReGUeST.PhySsicalPath 
Dim SIEEXMLPaALh AS SLIEING = Left (SEECULCTENEPALhN, 
LAS EE REV (SU ECUUEE OMED, #N#J) & OOO LALSL o 


'create a new XMLDocument object 
Dim objXMLDoc As New XmlDocument () 


LIEW 


'load the XML file into the XMLDocument object 
objJXMLDOC.Load (strXMLPath) 


Catch OBMjJEErOE AS Except i1 On 


ANSP LAY CEEOE delal lS 


OUEEE EOE . LANE HIM = <os* EEEOE WALLS AECESSLNE COCUMORNESIOS 
eS 

& GOO EK OK MESSAGE & OE [/Y & CO BK OK . SOUE CE 

EXIlIE SUD '"' and Sop Execution 

End Iry 


'now ready to parse the XML document 
iE MUSE Oe Well TOMES EO MIvVe OAC UIC NOUE CEO 


'create a string to hold the matching values found 
DIM SECHESULES AS SEEING = WEOSLLSE OE ALEMOESS/OS EOE #5» 


'"Erealé û NOGELISL Collection OF all matching ChIlG Rhodes 
Dim colElements As XmlNodeList 
colElements = objXMLDoc.GetElementsByTagname ("AuthorName'" ) 


"iterate through the collection getting the values of the 
en FEExXE MOE S FOR CACM OME 

Dim objNode As XmlNode 

For Each objNode In colElements 

strResults += objNode.FirstChild() .Value & "<br />" 

Next 


'then display the result 
outResults.innerHTIML = strResults 'display the result 


EMC SUNOS 


GJ SEE OILS 


€ / OOS 
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ET 


مثال: 

في المثال التالي سنقوم باستخدام غرض "٥١‏ 1ا٥00|"×‏ ثم تحميل وثيقة × إليه بواسطة الطريقة 
Load‏ . 

قمنا بتعريف تابع ليقوم بإعادة نوع العقدة ضمن الوثيقة بناءاً على الرقم الذي تعيده الطريقة ٥م ey‏ ل0 . 
ثم قمنا بتعريف تابع آخر يقوم باستعراض العقد وفحص العقد الأبناء لكل عقدة. 


GPage Language="VB" %> 
GImport Namespace="System.XML" $%> 


o90 


کک 
ک 


o9 


<IDOCTYPE BTML BUBLIC F/I WICIIDTID HIML 4.,0 TranslLional//ENT. 
<html><head> 

GELE LEZACCES SLANG ML COCUMENES USANE EME DOMICILE 

<!-- #include file="..\global\style.inc" =-> 

</head> 


OO OOCOLOESW EEE EEE NS 
<span class="heading">Accessing XML documents using the 
DOM SOAR E > 


OIF 10-F OULUOCURL" FUnNaAL=SeIVEL <O 
ALY 1E=POUEEEEOEY EUNAE =" SEK VEE HSER S/T 
<UIyY 1o ULRESULLES" EUNaAL= "SEVE IIi- 


<SEFIpt language="vb" runat="server"> 
Sub Page_lLoad() 


"create physical path to booklist.xml sample file (in same folder 
as ASPX page) 
Dim StErECurrentPath As String = ReglUeslt.BPhysicalPath 
Dam SEEIMLEAEN AS SEEMS — Mel E(SEECULEERE EAE A, 
SIE REV (SEECTUEEERIE EAE, LD) CS OOO SIE AML 


"create a new XMLDocument object 
Dim objXMLDoc As New XMLDocument () 


E 


'load the XML file into the XMLDocument object 
objJXMLDOC.Load(strXMLPath) 
OUEDOCURL , Ane MMM = WiOEMEC CLLES <OSN & SEK MLPA & UCAS 


Catch OBMjJEEIOE As Except 10n 
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"display CEEOE delal ls 


OUE EKE EOE . LANE ATM = W<OsS* ErEO WALL ACCOESSILNCT COCUMEORNESIOS . OE 
e 

& OSJEEEOE MESSAGE & "<O 7/2" & OOJEECEOE . SOUECE 

Ex1lt SUb ' and Stop €execulion 

ENG Try 


"How ready to parse the XML Gocument 

"iE MUSE Be well=formed to have loaded WIChOUE ETO 

'call a recursive function to iterate through all the nodes 
'in Ehé document creating a String thal ls placed in the <Iivs 
above 

Dim SEFNOGES AS SEEING 

outResults.innerHTML = strNodes & 
GetChildNodes (ob jJXMLDOcC.ChildNodes, 0) 


EMCO SUNOS 


Function GetChildNodes (objNodelList As XMLNodelList, intLevel As 
Integer) As String 


Dim SIINOGES AS String = 
Dim objNode As XMLNode 
Dim objAttr As XMLAttribute 


'iterate through all the child nodes for the current node 
For Each objNode In objNodeLlist 


ESP lEY AREOEMaAERON EOE EMSS MOE 
strNodes = strNodes & GetIndent (intLevel) _ 
& GetNodeType (objJNode.NodeType) & ": <b>" & objNode.Name 


"iF IE i1S an XML Declaration NOde, display the 'SDeclal' öroperltles 
If ob]jNode.NodeType = XMLNodeType.XmlDeclaration Then 

'cast the XMLNode object to an XmlDeclaration object 

Dim objXMLDec =CType (objNode, XmlDeclaration) 

strNodes = strNodes & "</b>&nbsp; version=<b>" & objXMLDec.Version 


& "</b>&nbsp; standalone=<b>" &4 objXMLDec.Standalone & "</b><br />" 
Else 

"Just display the generic 'value' property 

strNodes = strNodes & "</b>&nbsp; value=<b>" & objNode.Value <& 

e lo CE 

EMC AI 


'if it is an Element node, iterate through the Attributes 
EOLLECELOM ALSOLEAMALME LAME OLMA LON ZAOOUE CACM aE CIE LOUIE 
If objNode.NodeType = XMLNodeType.Element Then 
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'display the attribute information for each attribute 
For Each objAttr In objNode.Attributes 
strNodes = strNodes & GetIndent (intLevel + 1) 


& GetNodeType (objAttr.NodeType) & ": <b>" & objAttr.Name _ 
E TESS, Malu CO GC OOFAEEE aA NuEeE CG LV OE 
NEE 

El MI 


"iT Ehlis node has child nodes, Call the Same funcltloh FEcUFSIvEeLY 
"EG GIiSolay lhe Inf ormallon fot IE and Each GE ILS ChILGd node 

If objJNode.HasChildNodes Then 
strNodes = strNodes & GetChildNodes (objNode.childNodes, intLevel + 


El LE 
Next 'gğo to next node 
Return strNodes 'pass the result back to the caller 


MC UAC LOM 


Function GetIndent (intLlLevel As Integer) 

'relturns ã SIErInNG of non=-bréeaking Spaces used t6 indent each line 
Dim strIndent As String = "" 

Dim intIndent As Integer 


For intIndent = 0 To intLevel 
SERIE OME — SEE NRSERE € CENOSO, EROS, CNOSO 
NESE 


Re EU GSES REE AE 
EMC UOC E LOR 


Function GetNodeType(intType As Integer) As String 
"returns the node type as a string 
Select Case (intType) 


CaSsê 0U: REEUEN NONE LL 

Case LS REEUEN ENEMENEML 

Case 2: REEUEN ATTRIB ULE 

Case 3: RELUELN TENT" 

Case 4: ReEEUENn LCCDANA SECITONL 

Case 5: Return "ENTITY REFERENCE" 

Case G6: REECE LENET 

Case l1l: REEUEN LEROCEGSING INS RUCITON LE 
Case 8: Return "COMMENT" 

Case 9: Return "DOCUMENT" 

Case IO: KEEN DOC UMENL MER 

Case 11: Return "DOCUMENT FRAGMENT" 
Case 12: Return "NOTATION" 

Case L9: REEUEN IWHUNESEAGE 

Case LAE RETURN LOM GNU EGAN TE NETO ESEAGE 
Case 15: Return "END ELEMENT" 
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Case l6: Return FEND ENTITY” 

Case IU: REEUEN XMM DECLARANT ONE 
Ga Sê 1S REEUEN NODE AMT 

CaSê ESE: REEUE LUNESNOMN 
HMO Sele E 

BEL FUOMC E AON 


GJOCE LOLS 


€ OOS 
€JMEMLS 


مثال : 
سنستخدم في المثال التالي الغرض ١ع‏ uء1(0"×‏ مع الغرض ١20عNa۷1‏ )۴× لن نستخدم هنا 
الغرض ءلN0‏ ۷× وسنعيد نفس المثال السابق 


o0 


GPage Language="VB" %> 
GImport Namespace="System.Xml" $%> 
GImport Namespace="System.Xml.Xpath" $%> 


A A A 
o92 


o9 


CIDOCTYPE BTML PUBLIC T= MCI/DTID BIML 4.0 TransiLlional//ENTS 
SEM > < Re a 
<title>Accessing XML documents using an XPathNavigator</title> 
<!-- #include file="..\global\style.inc" =-> 

</head> 

IOOE# OOCOLOE=SH CELLE ENS 

<span class="heading">Accessing XML documents using an 
XPathNavigator</span><hr /> 


<l 10 GOULUOCURL" TuUnalLz=eervEr "5< Oi 
ALY 1E=OUEEEEOEY EUNAE = SER VEE HESEAOEOE < /ALTS 
IIT 1d=ToOULRSSULES" tUnNnaL=T SEVE Ii 


<SEEIpt language="vb" runat="server"> 
Sub Page_Load() 


"create physical path to booklist.xml sample file (in same folder 
as ASPX page) 

Dim StrCUrErenNntPath AS String = ReGguest.PhysilicalPath 

DAM SEE ZMLEAEN AS SEEMS — Met E (SEECUEEERE EAE MN, 

TRSIEE REV (SEECUEECRE AER, CL)) &C LOOO SIE Ml 


"create a new XmlDocument object 
Dim objXMLDoc As New XmlDocument 


LIE 
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' lO EME XM EAL 
objJXMLDOC.Load (strXMLPath) 
GULEDOCURL. Inner HIML = loaded fIle: <B>" & SIIXMLPaLh & FD 


Caen OOJEErEOE AS HCC 1 OM 


'display error details 


OUE BIE EOE o ALAREE ATM = W<OS* EEEOE WALL ACCESSINCT COCUMEONESIOS . OE 
Sl 

& OSJEEEOKE MESSAGE & "<o 2" &© OOJEECEOE . SOUECS 

EXLE SUD " and SOD CExeculLIlon 

ERN IE 


'now ready to parse the XML document 

'itl must be well-formed to have loaded without error 

"create a new XPathNavigator object using the XMLDocument object 
Dim objXPNav As XPathNavigator = objXMLDoc.CreateNavigator () 


move EMéê CURE OOSMEIOMN EO EMNE HOSE FOO UMERME MOE 
objXPNav.MoveToRoOt () 


'call a recursive function to iterate through all the nodes in the 
'XPaALNNSVLIGALOE, CrEalling a String Lhal ls placed in the <Iiuz 
above 

outResults.innerHTML = GetXxMLDocFragment (objXPNav, 0) 


Hel SMS 


Function GetXMLDocFragment (objXPNav As XPathNavigator, intlLevel As 
Integer) As String 


Di SELNOES AS SEEING = 
Dim inNELOOp As Integer 


Oi Slay AM OFmMaAE1 OM aASOUE EMIS MOE 

strNodes = strNodes & GetIndent (intLevel) _ 

& GetNodeType (objJXPNav.NodeType) &« ": <b>" & objJXPNav.Name _ 
& "</b>&nbsp; value=<b>" & objXPNav.Value & "</b><br />" 


'see if this node has any Attributes 
If objJXPNav.HasAttributes Then 


move EO EME EIESE AEE OEE 
objXPNav.MoveToFirstAttribute () 


Do 


'"O1LSBlay Lhe information about IE 
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strNodes = strNodes & GetIndent(intLevel #* 1) _ 

& GetNodeType (objJXPNav.NodeType) & ": <b>" & objXPNav.Name _ 
SE VBE SROSO, uae Ol & OOF NENaAV Value CG AD CO 
Loop While objXPNav.MoveToNextAttribute () 


'tLhen move back to the parent node (i.e. the element itself) 
objXPNav.MoveToParent () 


IEL E 


'see if this node has any child nodes 
If objJXPNav.HasChildren Then 


move EO ECNEéE KIS CNIS MOE OE ENCE CUEECRNE MOE 
objXPNav.MoveToFirstChild () 


DO 

'TECUFSIVELY call This Lunctlon Eo display the child node fragment 
strNodes = strNodes & GetXMLDocFragment (objXPNav, intLevel + 1) 
Loop While objXPNav.MoveToNext () 


'move back to the parent node - the node we started from when we 
moved EO EME fFISE CRIS MOS — CEU Mave USCS EUS AMS EOS 
instead 

objXPNav.MoveToParent () 


ERQ IE 


'must repeat the process for the remaining sibling nodes (i.e.nodes 
'at the same 'level' as the current node within the XML document 
'so repeat while we can move to the next sibling node 

Do While objXPNav.MoveToNext () 


'"TECULSIVELY Call this TUNCEIORN lG OIiSBlay LhISs SIBLING NOE 
"and LES @aLTIDUEeS and Child nodes 
strNodes = strNodes & GetXMLDocFragment (objXPNav, intLevel) 


Loop 
Return strNodes 'pass the result back to the caller 


EAC FUOCE LOR 


Function GetIndent (intLlLevel As Integer) 

'returns a string of non-breaking spaces used to indent each line 
Dim strIndent As String = "" 

Dim intlIndent As Integer 

For intIndent = 0 To intLevel 

SEBIR EME  SENIRGERE € CENOSO;, CASO, CMOS 
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Next 
Re E UE SEN EEE 
AC UMC E LOM 


Function GetNodeType(intType As Integer) As String 
"returns the node type as a string 
Select Case (intType) 


Caê Û RKELUKEA NONE 4 

CASS LF REC UKEM ELIM 

GaSe 2: REED AM TEN SUDE 

CASS 3F REE MEN WEI 

Case 4: REEUEN ODAN SECTION L 

CAS 32 RELUEA ENTITY REFERENCEY 

GaSe GC: REED LEN 

CASS 7: KElCUEA EROCSSSLNE LINSTLRUCELONY 
Case 8: Return "COMMENT" 

CA. 9F REECE DOC UMN 

Case 10: Return "DOCUMENT TYPE" 

Case 11: Return "DOCUMENT FRAGMENT" 
Case LZ: REEULN NOTATION 

GaSe LS: RECUR WHULESEBACGEHL 

Case l4: KEECUEN LSNENIEN CANT WHITESEAGE 
Caê 15S RELCUEA WEND BIME NY 

Case I6: Return FEND ENTITY 

Case IVS REET LX DECLARATION 

Ca Sê LSE REEUEN CNODE AL 

Case ElSe: REEUEN LUNKENOMN 


BEIM SE LEC 
MCL EUACE LOM 


CISC LOLS 


سنقوم بعمل مشابه للأمثلة السابقة هذه المرة باستخدام الغرض ١ءل1۲ex1Re4إX‏ 


<$@GPage Language="VB" %> 
<$@Import Namespace="System.XML" %> 


<l DOCT USE BTM AUBSLLCE =7 WIC DED MOML 4.0 TEAMSLELORAL 7/7 ENYS 
<html><head> 

<title>Accessing an XML document with an XMLTextReader 
object</title> 

€ 1= IME LUES E1LLe=Y o NOLOOALNEEVLE. LAG ==> 

</head> 

GIOOCY OGEOLOE=S WE E E NS 
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<span class="heading">Accessing an XML document with an 
XMLTextReader object</span><hr /> 


<dIy 10o ULDOCURLT FUnNnaL=Server <I 
GEL LEOWOUEEEEOE™ CURA =NEEE VOLE NS ERNOSOE SALTS 
OI 1G oOULRESUILLS" LCUNaAL =" SEITE O. 


<SEFIpt language="vb" runat="server"> 


Sub Page_Load() 


"Greate physical path Eo booklist. xml Sample filé (in Same folder 
as ASPX page) 
Dim StrECurréentPath AS String = Reqguest.PhysicalPath 
Dim strXMLPath As String = Left (strCurrentPath, 
LISE E ROV (SE ECUEEORLDEALM, NJ) & OOO LALSL o ML 


'declare a variable to hold an XmlTextReader object 
Dim objXMLReader As XmlTextReader 


LEW 
'create a new XmlTextReader object for the XML file 


objXMLReader = New XmlTextReader (strXMLPath) 
OUEDOCURL . AMAR oE HIM = OEE ELLES: <O & SCEMLPALM & </5 


Catch OBjJEErOE AS Except 10n 


Si SPLAY CEEOE delat lS 


OUERIE EOE o LAREE HTML = tos EEEOE WALLS AECEOSSLNT CAOCUMOMES/OS ¢ OE 
EN 

& OOK OK MESSAGE & HOE >" & CO EKEE OK . SOUE CE 

ExXlIE Sub '"' and SEO CEéCUEIoN 

ENG IIy 

"HOW FEeady LG Fea (OE GULL") the Nodes of Ehe XML GOCUMENE 


DLM SEENOLERESULE AS SEEING = WY 
Dim objNodeType As XmlNodeType 


mead eae MOE CN EU  ECEEUENS BAlSE 1 MO MOE MOCES EO GEA 
Do While objXMLReader . Read () 


'select on the type of the node (these are only some of the types) 
objNodeType = objXMLReader .NodeType 


Select Case objNodeType 


Case XmlNodeType.XmlDeclaration: 
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'get the name and value 
strNodeResult += "XML Declaration: <b>" & objJXMLReader.Name _ 
& " " & objXMLReader.Value & "</b><br />" 


Case XmlNodeType.Element : 
"just get the name, any value will be in next (#text) node 
strNodeResult += "Element: <b>" & objXMLReader.Name & "</b><br />" 


Case XmlNodeType . Text : 

USE GCiSOlay Ee valle, Modê MMe 1S FEEL A EM1 S5 CA 
strNodeResult += "&nbsp; - Value: <b>" & objXMLReader.Value _ 
& Ue OSOE 53 


BINO SELECE 


'see if this node has any attributes 
If objJXMLReader.AttributeCount > 0 Then 


"iterate through the attributes by moving to the next one 
'could use MoveToFirstAttribute but MoveToNextAttribute does 
"the same when the current node is an element-type node 

Do While objXMLReader.MoveToNextAttribute () 


'get the attribute name and value 

strNodeResult += "&nbsp; - Attribute: <b>" & objXMLReader.Name _ 
& "</b> &nbsp; Value: <b>" & objXMLReader.Value _ 

& WESC A> 

Loop 


ERO IE 


Loop "and read the Next node 


ini Shed WIEN ۓEAê‎ Gede SO CIOS E 
objXMLReader. Close () 


'and display the results in the page 
outResults.innerHTML = strNodeResult 


AG SU 


GJOCE LOLS 


€ / OOS 
€ MEL > 


مثال: 
في المثال التالي سنقوم باستخدام الغرض XM] ×) W!١‏ وسنقوم بكتابة وثيقة ۷1> بواسطته. نلاحظ 
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ننا بدأنا بإنشاء الغرض ١عا|٣W×١١۳”1×‏ ثم قمنا بتحديد التنسيق (مقدار الإزاحة بين العناصر) من ثم بدأنا 
بكتابة الوثيقة باستخدام طرق الغرض مJû g WriteComment gy WriteStar{D0cUIent‏ 


.... WriteStartElement 
.٤اهوع ثم قمنا بتفريغ محتوى الغرض إلى الملف وإغلقنا الملف باستخدام الطريقتين طءںا؟ و‎ 
بعدها قمنا بفتح الملف وتحميل محتواه إلى سلسة محارف تم قمنا بكتابة المحتوى إلى عنصر التحكم من جهة‎ 


OurResultaڏخnئl‎ 


€ l DOC HEE HMIML BUSLLC FF AMICI DID EIML 4.0 TEang1ltcional £ /ENES 


"create physical path for the new file (in same folder as ASPX 


215 


<title>Creating an XML document with an XMLTextWriter 


<span class="heading">Creating an XML document with an 


objJXMLWriter = New XmlTextWriter (strXMLPath, Nothing) 
OUE DOCUEL , LAMREO EME = Mri CINE EO EAL6S OS" &€ SECDA & </lOS 


<$@GPage Language="VB" %> 
<$@Import Namespace="System. XML" &% 
<%5@ Import Namespace="System. lO" % 


2 
> 


<M < ME EE 


OO ECESALLLLE> 
€1l—— IME LUES E1LLOe=Y . o NOLOOALNSEVLES LAG ==> 
</head> 

<IOOCY OOCEOLOIE=SW E EEE EMS 


XMLTextWriter object</span><hr /> 


<OIY 10 TGOULDOCURL" TFUnNaAL= Teer VEI <OL> 
dL 1E=POUEEECEOEY EURAE = SE VEE VESEAOEDE </A> 
CII 10=TOULRESULES" TUNaAL="SEEVEE <O 


<SEFIpt language="vb" runat="server"> 


Sub Page_LlLoad() 


page) 

Dim sStrCurrentPath As String = Reqgquest.PhysicalPath 
Dim StrXMLPalth AS String = LEell(StrCuUrrEnNntPath, 
INSEITEEVISLICULTENECRALN, TTT E TEVL oOOEIILST MIT 


'declare a variable to hold an XmlTextWriter object 
Dim objXMLWriter As XmlTextWriter 


EW 


'create a new objXMLWriter object for the XML file 
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Catch ob]JError As Exception 


SM SOLAVY CEEOE dela lS 


OUEEE EOE o LANE ATML = UO EEO WALLS AECESSLRCE COC UMONESIOS . OE 
N 

& OO JEKE EOE MESSAGE & <O JE" & COOJEEEOK . SOU CE 

Exit Sub '"' and stop execution 

End TIry 


'now ready to write (or "push") the nodes for the new XML document 


"turn On Indenlted formalling and sét indent Io 3 Chararclers 
obğjXMLWriter.Formatting = Formatting. Indented 
objJXMLWriter. Indentation = 3 


"Start the document with the XML declaration tag 
objJXMLWriter.WriteStartDocument () 


EN Ele @ COMMER CEME MECNUN EAE CUE CAE 7EME 
objJXMLWriter.WriteComment ("Created using an XMLTextWriter —- " & 
Now () ) 


'write the opening tag for the <BookList> root element 
objJXMLWriter.WriteStartElement ("Booklist") 


'write the opening tag for a <Book> element 
objJXMLWriter.WriteStartElement ("Book") 


'add two attributes to this element's opening tag 
objJXMLWriter.WriteAttributeString ("Category", "Technology") 
Dig ANCE ECOUAL AS INEEGEE = L246 'numeric value to convert 
objJXMLWriter.WriteAttributeString ("Pagecount", 
intPageCount.ToString ("G") ) 


'write four elements, using different source data types 
objXMLWriter.WriteElementString ("Title", "Professional Video 
Recorder Programming") 

Dim datReleaseDate As DateTime = #03/03/2000# 
objJXMLWriter.WriteElementString ("ReleaseDate", 
datReleaseDate.ToString ("yyyy-MM-dd") ) 

Dim intSales As Integer = 17492 
objJXMLWriter.WriteElementString ("Sales", intSales.ToString ("G") ) 
Dim blnHartdback As Boolean = True 

objJXMLWriter.WriteElementString ("Hardback", blnHardback.ToString () ) 


'write the opening tag for the <AuthorList> child element 
objJXMLWriter.WriteStartElement ("AuthorList") 


'add two <Author> elements 
objJXMLWriter.WriteElementString ("Author", "Francesca Unix") 
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objJXMLWriter.WriteElementString ("Author", "William Soft") 


el OSe ENe CAUENOE IM SE CElem Ê 
objJXMLWriter.WriteEndElement () 


le lOSE EME <ÊEOOlkK ELEM E 
objJXMLWriter.WriteEndElement () 


'close the root <BookList> element 
objJXMLWriter.WriteEndElement () 


TEIUSM Ene CUEEENE CGONECMNE EO EMe Elê aM GI OSE E 
objJXMLWriter.Flush () 
objJXMLWriter.Close () 


'now open the new XML file and read it into a string 
Dim strXMLResult As String 

Dim objSR As StreamReader = File.OpenText (strXMLPath) 
StrXMLResult = ob]SR.ReadToEnd() 

ObDISR.CloSse 

Olo JOE — MON ME, 


'and display the results in the page 
oOuUutResults.innerHTIML = "<pre>" & Server. HimMlEnNncode (StErEXMLResSsuUltE) & 
"<BDEE>L 


MG SUS 
CJ SOCIO 


€ /OOdYS 
EM 


القضل الخامس كث واسادس غشر 


عنوان الموضوع: 
الأمان في ASP.NET‏ 


الكلمات المفتاحية: 


ملخض : 
يعد موضو ع الأمان موضوع ذو حساسية كبيرة بالأخص في بيئة كبيئة الوب. سنغطي خلال هاتين الجلستين مواضيع الأمان بما 
يشمل ۸8۴.N£E1‏ وتداخلاتها مع الأمان في 118 و Windows‏ 
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أهداف تعليمية: 

يتعرف الطالب في هذا الفصل على: 

٠ه‏ مفاهيم الأمان 

Wiمل0سs اللتحقق من الهوية في 118 و‎ ٠ 
Windows التحكم بالسماحيات في 118 و‎ . 
ASP.NET إجراءات الأمان الخاصة ب‎ ٠ 


الأمان في ASP.NET‏ 


جرى تصميم أغلب الصفحات على الانترنت ليتم الوصول إليها من أي زائر. لذا تكون الإعدادات التلقائية في 
SP. 1‏ أمثليةء فأي شخص يستطيع الوصول إلى أي صفحة من أي مكان على الانترنت. 


لكننا نحتاج دائماً إلى جعل صفحات غير متوفرة للعامة. فعلى سبيل المثال قد تحتاج إلى حصر الوصول إلى 
موقع کامل 1 چ مين غير 1 جلير ¢ أو حصر الوصول إلى صفحات معينة لمدير النظام فقط. 


عموماء كانت عملية تأمين الصفحات في النسخة السابقة (45۶) تتم باستخدام إحدى طريقيتن : 

٠‏ إنشاء نظام أمان مخصص يسمح للمستخدمين بالدخول إلى الموقع أو التطبيق 

٠‏ الاعتماد على خصائص الأمان في 118 و sسهلم۷‏ لتحديد المستخدمين الذين يمكن لهم الوصول إلى 
الصفحات» أو المجلدات» أو الموارد 


تكون الصفحات في ۸5۴.٤٣‏ عاملة في إطار .N81‏ حيث تحافظ على ميزات الأمان القديمة مع إضافة 


قاف جديدة قشر ها ف ار اتح فة كا مركن جع السات الى تكم فى وصرل 
المستخدم ونركز على تلك المصممة للعمل خصيصا مع آ٤۸$۴.N۴.‏ 


مفاهيم الأمن 
يرتكز الأمن عادة على أربعة مواضيع رئيسية: 
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٠‏ التحقق من الهوية 

٠‏ الصلاحيات والسماحيات 

٠‏ التمثيل 

٠‏ الأمان الوظيفي أو أمان البيانات 


يرتكز الأمن عادة على أربعة مواضيع رئيسية: 


التحقق من الهوية: 

وهي العملية التي نقوم بها لتمييز هوية كل مستخدم بجعله يثبت أنه من يدعي. فعند السماح لمستخدم معين 
بالوصول إلى موارد منظومةء يجب أن نكون قادرين على التعرف عليه. ويجري الأمر غالبا باستخدام اسم 
دخول وكلمة سر أو شهادة رقمية أو بطاقة ذكية أو حتى قارئ بصمات. 


الصلاحيات والسماحيات: 

بعد معرفة من هو المستخدم نستطيع اتخاذ قرار بشأن إمكانياته وسماحيات وصوله للموارد المختلفة. تجري 
هذه العملية باستخدام مجموعة من الطرق كقائمة التحقق من الوصول إلى غرض (ا1٤A).‏ فعلى سبيل 
المثال: إذا طلب أحد الأشخاص الوصول إلى صفحة ۸5۶ء يتحقق النظام من كون هذا الشخص يملك حق 
قراءة هذه الصفحة قبل أن يسمح ل 118 بجلب تلك الصفحة. 


التمثيل: 
يعرف التمتيل على أنه وصول لمصدر ما باسم آخر وتحت هوية شخص آخر. فعلى سبيل المتالء تستخدم 
آلية التحقق من الهوية مع جميع الصفحات حتى تلك المفتوحة على الجميع» ولكن الأمر يجري في الحالة 
الأخيرة باستخدام حسابين لهما طابع الضيف (اءع6u)‏ أو المجهول (ئuامدصر«صممصA)‏ يكون الحساب الأول 
بام [SER _(machinename%‏ و الحساب الثاني .TWAM_%machinename%‏ 
يجري تجهيز هذه الحسابات عند تنصيب 118ء وتجري إضافتها آلياً إلى جميع المجلدات في جميع المواقع 
على المخدم. فإذا سمحنا بوصول غير مشروط إلى مصدر ما في 115 سيبدو جميع المستخدمين كمستخدم 
واحد من خلال الحساب عصmachinenam_ P15٤۸‏ الذي سيسمح بالوصول إلى المصدر بالنيابة عن 
المستخدم. 

أما إذا كان المصدر المراد الوصول إليه صفحة تستخدم المكونات 0M‏ أو C0۷N+‏ فيجري استخدام 
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الحساب ع۳إ4١عمنطعةص_1۷A۸NN‏ لينوب عن المستخدم غير المعرف. 

يقتصر التحكم بالوصول إلى الملفات في ۸5۴.٤1٣‏ على تلك المعرّفة كملفات تطبيق وهي تشمل ×مكه. »› 
جه. » »ع. » ط۷. » ءء. إضافة إلى ملفات خدمات الوب وموارد أخرى تم ربطها إلى الملف 
ASPNET_isap 11‏ . و لاتطبق قواعد الوصول إلى ملفات مثل الصور وملفات ٥0ء‏ مء لم حيث 
يجري التحكم بحماية هذه الملفات باستخدام تقنيات sس0لمW1‏ المعيارية مثل ۔ا٣۸.‏ 


الأمان الوظيفي أو أمان البيانات: 
يتضمن عملية تأمين النظام بالمعنى الفيزيائي كتحديث نظام التشغيل واستخدام نسخ مستقرة من البرامج. 


الأمان في ASP.NET‏ 


ذكرنا سابقا بعض الفروقات بين الطريقة التقليدية التي كانت متبعة لضبط الإعدادات في ۸8۴.٤۲‏ وبين 
سلفها 48۶ ور أينا أن عملية الضبط تتم باستخدام ملف عا؟«هء.ط٠س‏ الذي يقوم بتعديل المعلومات التينفسها 
التي يمكن إعدادها من واجهة مدير خدمات الإنترنت M؟1‏ (ضمن )M M٣‏ . 


على أي حال» تبقى إعدادات الأمان المطبقة في 118 فعالة لأنه -وبعكس الإعدادات الخاصة بالتطبيقات- ما 
يزال 118 يدير الطلبات وعمليات الأمان بالتعاون مع ۸5۴.٤٣‏ إذ يتسلم 118 الطلب ويقوم بتحويله إلى 
ASP. NE‏ . يمكننا رؤية الإعدادات المتعلقة بعملية التحويل تلك من خلال فتح نافذö Application‏ 


: Configuration 


Default Web Sle Properties 1 


Application Configuratine EH 


Documertks | Oirecioey Securky أ‎ HTTF Headeıs | Cuslam Emors 2 
Web Sile | Dperelois | Pstamanss | ISP Filers Home Pisco App Mappa | App Optre | App Debuggira | 
wer corneclirg bo hit resarce, He conlenl should come frarrt fF ache HA ape mlont 


fF A Jedoylocahad or Ihe cam pula 
1 û thar kacaled on an giha compuher 
TF A rader ta 2 URL 


Local Palh xinelpub tran Broa 


-Ãêpplalion api gê 
Enpeutable Path [ehe _& 
aan CI HHT Mia ral ALT Fic h1 5 
ark LC WAINHT ‘Microsoft MET AFramaarkî. GET HEAD 
ah CI NHT Micoealt ME TFs,  GETHE4D 


I Seipl sauce noces: # Log isla asme ENN Merce NET \Fianrarkî,_ GET HEAD 
7 Fe # rrhe lit rêtauicE |aspk eI HHT MMicrceoft MET Frameworkh OET HEADY 
aad CAH Miznceatt HE TAFrarrearhkh,  GET,HEAD 


E INHT icsoeft ME TFrane 
TF . GET HEAD 

nı HET HEAD 

„». GET.HEAD 


“4. RET HEAD 
i ET e 
۴ 
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نلاحظ أنه يتم تحويل جميع الطلبات التي تتناول اللاحقات الظاهرة إلى الملف 11ل.4p1ء1_٥١مءه‏ في المجلد 
الخاص بإطار عمل ۲ .×"٤‏ 


فيمايلي شكل يوضح المخطط التدفقي لطلب صفحة ما: 


Request User's IP address ArOnNYTIOLIS Execute under 
or dormairi es} AĞĞESS IWSRE_machinenamê 
permitted aAlcCess? enabled? ACCOUNE 


15 


Derled 
Windows 2000 


Authenticatê USEF 
wla Windows Z000 


Authenticated’? 


ASP.NET 


Performing ASE.NET 
Send resource related security &— 
to client cheeks 


ترجمة الشكل 
طلب Request‏ 
هل عنوان المستخدم أو عنوان المجال User’s IP Address or domain‏ 
Permitted access?‏ 
مقبول؟ 
هل يُسمح بالدخول المجهول الهوية؟ Anonymous Access Enabled?‏ 
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Execute under ul تشغبل تہ“‎ 


IUSR_%machinename%® account TIUSR #rachinenathé® 
Denied ممنوع‎ 
Send Resource to Client إرسال المورد إلى الزبون‎ 
Authenticate user via Windows التحقق من هوية المستخدم اعتماداً على‎ 
0 Windows 2000 
Authenticated جرى التحقق من الهوية‎ 
Performing ASP.Net Related تنفيذ إجراءات الأمان الخاصة ب‎ 
Security checks ASP.NET 
Yes نعم‎ 
No كلا‎ 


الصلاحيات في Windows2000‏ 


تحتفظ 2000 ۷|۵0۷ بقائمة من المستخدمين الذين يُسمح لهم الوصول إلى المصادر المختلفة على 
الجهاز. يمكن أن تكون هذه القائمة محفوظة على الجهاز نفسه أو على جهاز آخر يعمل كتحكم نطاق. 


يجري التحكم بهذه القائمة عن طریق İداö Active ölدÎ Jاڵlخ ja gİ ComputerMarnageme nt‏ 
Users‏ ا ضمن أدوات التحكم بالنطاق. 
o EEE E 5‏ || 


Tree | 1 nama [Ful Nare [Lesrpian 


Buik- =İrı account For administering Bs CoN. 


Campukar Management [Local 


Tik System Tonk Bulkt-nı account for gest access to tha Cû... 
Event Yiewner Internet yest Accor Built-In account for anonpmiolks actess bl ... 
8 Swsbam Information Launch II5 Frocass Aecount Built-in account For Irktetriek IrfotTiatiorl 5... 
E Pêrfcrmêafılê U Lag and Aerts relowis Media services i... endows Media sêr vicês run urler thi af... 
۴ Shared Folders د‎ EE SLAhgerbCMAExEE SL Server Agent CmdExee Jeb Step Act... 
--- JE, Deyka Manager -HiTestl le 1 Test ûercount Far demonstrating seourity feakbures only 
| Leral ers aê Greups 1 Tslntermetllser This user accourÊ is used by Terminal Ser... 
: 3 l5 
I دود‎ 
3 ا‎ 3kor age 
ا‎ A bisk Management 


“Î Cek Defragmenter 
ED Logcal Lrryes 
î Remarable Storage 
H-p Services and Applications 
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توفر مجموعات المستخدمين العناء في حال رغبنا بتوزيع مجموعة كبيرة من المستخدمين بصلاحيات 
تاها رض عن أغذاك ادمات 500 نکم الرضرں لی مورت ما والاشط رار کے یر وه 
الصلاحيات بصورة إفرادية عند طلب أي تغيير. يكفي إنشاء مجموعة وإعطاء هذه المجموعة الصلاحيات 
المطلوبة على المصدر المحدد. وفي حال طرأً أي تغيير على تلك الصلاحيات يكفي تغيير الصلاحيات 
الخاصة بالمجموعة لتؤثر على كل المستخدمين الذين ينتمون إليها. 

توضح النافذة التالية مستخدم عضو في مجمو عتين !|0Up 1e5‏ 6 و Users‏ 


التحقق من الهوية في IIS‏ 


عندما يقوم مستخدم بطلب مورد ما باستخدام الوب» يقوم 118 باستلام الطلب وإجراء عملية التحقق الأساسية 
عليه» كما يقوم بمجموعة من الاختبارات قبل منحه الوصول إلى المصدر المطلوب : 


اختبار عنوان 1۲ و النطاق: 

يمكننا في Win ws 2000 Seve‏ و N1‏ تخصيص عناوين 1۴ أو أسماء نطاق للزبائن المسموح لهم 
الوصول إلى الموارد المختلفة. يتم ذلك باستخدام واجهة 1P Address and Domain Name‏ من التبویب 
Directory Security‏ في النافذة sع1٤۲‏ ٥م۴۲0‏ الخاصة بموقع ما ضمن 115. 

تساعد هذه العملية في الوصول بصورة دائمة إلى الموقع من عنوان أو مجموعة محددة من العناوين. 

استخدام الشهادات الرقمية لتعريف المستخدمين: 

يمكننا أيضاً استخدام النافذة كمن٤إ6مهإ۴‏ لإعداد مخدم شهادات رقمية ليجري استخدامها من أجل موقع ما. 
كذلك يمكننا تفعيل الاتصال الآمن باستخدام 1؟S.‏ يمكن لهذه الشهادات الرقمية أن تستخدم مع الشهادات من 
طرف الزبون للتعرف على الجهاز الذي يحاول الوصول إلى المخدم. 


تحديد آلية التحقق من الهوية في 118 


نلاحظ في النافذة الخاصة ب رإأاالاءم؟ رإهاءه1۲ وجود خيار يسمح لنا بتحديد طريقة التحقق من الهوية 
اتی بک كايا 


تفدم liفذة Authentication Methods‏ ار بعة خيارات رئيسية: 
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الوصول بدون اسم › حيث يمكن لأي مستخدم الوصول إلى خدمة 0۷۷ في حال لم يجر حجبه بحسب 
عنوان 1۴ الخاص به أو بسبب القيد الخاص باسم النطاق. يقوم 118 عندها بالوصول بالنيابة عن المستخدم 
باستعماJ‏ الحساب [USER‏ ڍو .TWAM‏ 


الوصول باستخدام اختبار الهوية الأساسي: عند إلغاء تفعيل الوصول بدون اسم. يجري توليد نافذة تسجيل 
کن ان ن ان ار ف ار ا ا كه رر ا لى 11 ةا 
يقوم 118 بالبحث عن الحساب في س0ل« ويمنح سماحية الوصول للمستخدم على المصادر التي يمتلك 
أحقية الوصول إليها. لا بد من ملاحظة أن التشفير المستخدم والمبني على ط64 ليس آمناً بقدر كبير لذلك لا 
يعتبر هذا الخيار مناسباً في التطبيقات التي تحتاج درجة أمان عالية. 


التحقق من الهوية عن طريق إرسال مجموعة من المعلومات المشفرة إلى المخدم (6ئعع01): إذا تم إلغاء 
تفعيل الوصول بدون اسم» يجري إظهار نافذة تطلب معلومات اسم المستخدم وكلمة السر. يقوم المستعرض 
بجمع هذه المعلومات مع معلومات أخرى مخزنة على الجهاز الزبون وإرسالها بعد تشفيرها إلى المخدم 
(باستخدام توابع تشفير باتجاه واحد). بالطبع»ء يملك المخدم نسخته من هذه المعلومات ويقوم بتشفيرها بدوره ثم 
تتم المقارنة بين ما وصل إلى المخدم والنسخة التي تم إنشاؤها. تعمل هذه الطريقة فقط باستخدام مستعرض 
الانترنت 1۴ وخدمات انترنت .N٤١‏ ولكنها فعالة حتى أن بإمكانها تخطي حواجز كالمخدمات الوكيلة أو 
جدران النار» وهي آمنة إذ لن يُسمح للمستخدم بالوصول إلى مصدر ما مالم يملك هذا المستخدم حساب صالح 
على sSس0ل‏ "م۷1 ويكون لهذا الحساب صلاحيات الوصول إلى المورد المحدد. 


استخدام تحقق الهوية الخاص ب كس0لد۷1: تستخدم كس0لم۷1 عادة طريقة مشابهة للطريقة السابقة 
وذلك باعتماد برتوکول تشفير مثل ١٥۲٥طK۲‏ أو استخدام البروتوكول N11١۷‏ الفرق الأساسي في أن هذه 
الطريقة غير ملائمة للعمل على الانترنت لأن هذه العملية لا يمكن أن تتم من خلف جدار نار أو ملقم وكيل. 
في حال تم إلغاء التفعيل للدخول بدون اسم وتم تفعيل كل الخيارات الأخرى» سيستعمل 118 تحقق الهوية 
الخاص ب كس0لدW1‏ ثم تحقق الهوية بالطريقة كمع ثم تحقق الهوية الأساسي كحل أخير في حال كون 
الزبون لا يدعم الطريقتين الأولى والثانية. 


يمكننا استخدام النافذة الخاصة ب كل0طاMe‏ م«ntictioعAuth‏ لتحديد الحساب المراد استخدامه في حالة 
الدخول بدون اسم 
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يمكن الوصول إلى المحتوى نفسه بر ك ڊulتخڏlم .Request.ClientCertificateCo1lecti0n‏ 


testarccount Properties 


تجري إضافة جميع الحسابات آليأً إلى إلى مجموعة كإهول. 


نلاحظ في الشكل التالي جميع المجموعات المتوفرة تلقائياً إضافة إلى المجموعة الجديدة pنه۲ ٣٠۶۲6‏ التي 
فا واش 
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CaormipiitEr ManaãqEmIET HEI x‏ ا 


| aim vw |e 3m ER @ 


Computer Management Local) LA Administrators Admiristrators have complete and unrestricted ... 

5 Ê Syskem Tonls Backup Oper abors Eackup Gperators cani override security restrict, ., 

Evert lemer : ELLE GuiêaEs hava Eha 3aaîê seleas aa members öf tf...‏ 7 8 ا 

` Û Sytem information Power LlsErS Power Jers possess mask administratiye powê,.. 
أ‎ EH: 3 Ferfortmance Logs and Alerts Replicator Supports Fle replcaklon in a domain 

E: Shared Folders E Users Jers are preverted from making accidental ûr ı., 

Gevice Manager Ê Debugger Users Debugger uzers çan debug processes on ths mm...‏ ا 

; E Local Users and aroups #4 NetShowe Administrators Members can fully administer Windorwes Media 5... 
i ers E Tetaroup For demanstr aking security Features 


` SEE 
-Ê] Skorage 
` ¬ Disk Managemert 
f Disk Defragmenter 
j TE Logical Drives 

A ËÎ Removable Storage 
5 He Services and Applications 


السماحيات في 2000 Windows‏ 


بعد التحقق من هوية المستخدمين» لن يتمكن أي منهم من الوصول إلى المصادر التي لا يمتلك سماحية 
الرضرل لها يتم تخزين مغلومات الساحبات هادة فى فة تحك الرصرل ©4 النخضصة لكل مضدر 


TT 
فف كن باتكك كان اتساسات كل اققات و لات اة‎ ٠ هكن ار اقا بخ طن‎ 
والشبكية.‎ 


من نافذة را۲عمه۴۲ نختار التبويب رااالاءمS‏ مما يسمح بعرض الحسابات والمجموعات والسماحيات التي 

تملكها كل منها في الوصول إلى ملف أو مجلد. 

يمكن باستخدام الزر ۸4۷2,٥٥4‏ إظهار نافذة للتحكم بتفاصيل أكثر معطية المجال ل 13 تركيب مختلف من 

صلاحيات القراءة/الكتابة/الحذف.مع إمكانية التحكم بتوريث المجلدات الأبناء السماحيات المطبقة على 
المجلدات الأباء. 


Universal Knowledge Solutions s.a.1 227 


Allow INSA_PAIMAOSE-DC |... Feed B Exsc... 1 olde, EIT ard es [ 
i lum: TwêM_PRIMAOSE OC.. Fraud bh Exec... Tle bldeı, auLluklleız oral Arca 
An SSTEH Fead b Enec,, The talder, sutloldars ard fes 


السماحيات في || 


يتدخل |S‏ أيضا في تحديد سماحيات الوصول على الموارد كونه يقوم بالوصول إلى الموارد بالنيابة عن 
المستخدم باستعمال الحساب (۸٤5ل1ا|)‏ أو أي حساب آخر يحدده المستخدم» كما يحدد على سوية أخرى ما 
الذي يمكن أن يفعل المستخدم بالمصدر الذي تم الوصول إليه. 


يظهر في الجزء الوسطي من تبويب 0۲۷ء06 1٠١۳6‏ الظاهر في الشكل أدناه العمليات الممكنة على 
الموقع أو المجلد قراءة/كتابة/تشغيل النصوص البرمجية . 
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Default Web Site Properties 


I Log 
I nde 


ITI 


Default Application 1 


Medium [Fooled] a 


تكون هذه السماحيات منفصلة عن تلك التي يطبقها ۷00۷S‏ ويتم تطبيقها اعتماداً على المجلد أو الموقع 
مما يوفر طبقة حماية إضافيةء إذ تعمل السماحيات التي يحددها ۸00۷WS‏ أ۷ مع سماحيات 5||. 


إجراءات الأمان في ASP.NET‏ 


بعد استعراضنا لمجموعة من الأساسيات المتعلقة بأمان نظام التشغيل وأمان 118 سنرى كيف ترتبط هذه 
المواضيع بميزات الأمان المتوفرة في ۲.٤1‏ ۸5. 


يوضح الشكل التالي إجراءات الأمان في ۸8۲.٤٣‏ بتفصيل أكبر. 
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سے 
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ASP.NET receives request 
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Run under user account (or TUser 
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Performing ASP.Net Related 
Security checks 


Denied 
Send Resource to Client 


Yes 
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No كلا‎ 


إجراءات الأمان في ASP.NET‏ 


التمثیل في ۲.۸٤‏ ۸8: 


تتلخص الخطوة الأولى ضمن 48۴.٤‏ في اختبار فيما إذا كان التطبيق مضبوطاً لاستخدام التمثيل. 

يكون المفهوم مشابه لمفهوم التمتيل في 118 مع ضرورة اتخاذ القرار فيما إذا كان طلب المستخدم سينفذ 
بصلاحیات المستخدم آم بصلاحیات حساب خاص تستخدمه ۸8۴.٤٣‏ للطلبات بدون اسم. یمکن التحکم 
بحساب المستخدم فعلياً من خلال العنصر <اعProcessMod<‏ ضمن ملف الإعدlدlٽت .machine.config‏ 
يكون اسم المستخدم التلقائي هو ”ع1nطcعھص“‏ وتکون کلمة lئuر .“AutoGenerate”‏ 


€ إذا كان التمثيل مفعلا في ASP.NE۲‏ 

0 ا گان الفخرل من درن اس مشعلا فى 175 ي التعامل مع الظلتب باشكام الحمات الخاص 
بالدخول بدون اسم في 115 وهو 12% JUSER_%machinenıa‏ . 

0 إا كان الوصول بدون اسم غير مفعل في 11S‏ عندها يتم التعامل مع الطلب اعتمادا على احساب 
الخاص بالمستخدم مرسل الطلب. 

o‏ في كلا الحالتين يتم التحقق من قائمة 4٣1‏ للموارد التي تم طلبها من قبل المستخدم حيث يجري 
الستاح برضل إلى الفررد | كان الاب الست يسح العمل مم ها المورد. 


€ إا كان التمثيل غير مفعل في :ASP.N ٤1‏ 

0 إذا كان الدخول بدون اسم مفعل يتم التعامل مع الطلب باستخدام الحساب الخاص بالإجراء 
ASP.NET‏ 

Windows ils ê EAN aS Eê ENE ھ‎ 
الخاص بالمستخدم مرسل الطلب.‎ 

o‏ في كلا الحالتين يتم التحقق من قائمة ۸٣1‏ للموارد التي تم طلبها من قبل المستخدم حيث يجري 
السماح بالوصول إلى المورد إذا كان الحساب المستخدم يسمح بالعمل مع هذا المصدر. 
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خيارات الأمان في ASP.NET‏ 


تقدم SP.N£1‏ مجموعة من الخیارات لتطبیق الأمان وتقييد وصول المست لمستخدم في تطبيقات الوب .يمكن 
ضبط كل هذه الخيارات ضمن الملف عاگ«هء.طاءس الموجود ضمن المجلد الجذر للتطبيق. 


قمنا سابقاً بدراسة كيفية استخدام هذا الملف لذلك سنركز على مواضيع التعامل مع التحقق من الهوية 
الشاضات: 


أنواع تحقق الهوية والسماحيات: 
تقدم p.[6ءA‏ ثلاثة أنواع من تحقق الهوية والسماحيات. كما يمكننا الاعتماد فقط على 118 ليقوم بكامل 
العمل. الخيارات هي : 


النوع الاسم الوصف 
تحقق الهوية يتم التحقق من الهوية من قبل 115 باستخدام 
لاضن طرق الكو اقا 
(Basic,Digest, Windows) Windows‏ 
تحقق الهوية المبني Passpo‏ يستخدم هذا الخيار طريقة التحقق من الهوية 
rt yJePassport‏ المركزية التي تقدمها شركة مايكروسوفت. 


يتم توجيه الطلبات التي لم يتم التحقق من 
هوية مرسليھا إلڪ نماذج .HTML‏ 

هة الطر فة اة للك تة اقا 
في 5۶ 4ولكن يتم تقديم أغلب الوظائف هنا 


على مستوی Forms‏ يُدخل المستخدم معلومات اسم المستخدم 
النماذج وكلمة المرور. يقوم التطبيق بقبول هوية 


المستخدم وإنشاء كعكة تحتوي معلوماته . 
يتم إرسال الطلبات اللاحقة مرفقة مع 
معلومات الكعكة بحيث تضمن استمرار 
تعرف صفحات التطبيق على هذا المستخدم. 
التحقق من الهوية ٥#‏ __ هذه هي الوضعية التلقائية » يمكن أن 
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85 لتلقائي في يستخدم التمثيل أيضأ ولكن التحكم بالوصول 
يبقى مرتبطاً بالقيود المحددة في 1[8. يتم 
الوصول إلى المصادر باستخدام حساب 
SPN‏ الخاص بالإجراء أو بواسطة 
الحساب 105٤۸‏ في حال تفعيل التمثيل. 


خيارات الأمان في ASP.NET‏ 


يتم تحديد نوع التحقق من الهوية المطلوب لتطبيق أو مجلد ضمن العنصر <١0نةء‏ نا١6‏ طاناه> في ملف 
عconf.اwe‏ لهذا الموقع أو المجلد كما يلي: 


<configuration> 


<system.web> 

<authentication mode="Windows|Passport| Forms|None"> 
authentication options used for the application 
</authentication > 

<authorization > 

users and roles that have access to the application 
</authorization > 

<identity> 

if application should run under a different account 
</identity> 

</system.web> 


</configuration> 
العنصران الآخران اللذان نهتم بهما ضمن القسم <طاع2.wع)ءرء> من الملف عاگمb.coعمw هما‎ 
و <رitاenلi>. يُستخدم الأول لتحديد المستخدمين والمجموعات التي تستطيع أو لا‎ >authoriati0n< 
تستطيع الوصول إلى التطبيق. ويُستخدم الثاني لتحديد فيما إذا كان التمثيل مفعل أم لا.‎ 


خیارات الأمان في ۸SP.NE۲‏ 


استخدام التحقق من الصحة من النوع ws‏ d0ہW1‏ : 
يناسب هذا النوع تطبيقات إنترانت أو التطبيقات التي يمكننا مسبقاً تحديد المستخدمين الذين يحتاجون للوصول 
إليها وذلك لضرورة إعداد حساب كس0لم1 للمستخدم الراغب بالعمل على هذه التطبيقات. 
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يتم إعداد استخدام هذه النوع ضمن الملف عاگدصهء.اءس على الشكل: 
<configuration>‏ 
<system.web>‏ 
<authentication mode="Windows" />‏ 
<identity impersonate="true" />‏ 


</system.web> 
</configuration> 


تحديد المستخدمين والمجموعات: 


يمكننا تحديد قائمة بالمستخدمين والمجموعات التي لها الحق بالوصول إلى التطبيق وذلك ضمن العنصر 
>authorizati0n<‏ في سلسة من عناصر <0 ااه> و<رمعل> وذلك بالشکل: 


<allow roles="comma-separated list of Windows account group names" 
users="comma-separated list of Windows user account names" 
verb="GET|POST|HEAD" 

/> 

<deny roles="comma-separated list of Windows account group names" 
users="comma-separated list of Windows user account names" 
verb="GET|POST| HEAD" 

/> 


فاكف لضا وان فن اناا 
الرمز (*) للتعبير عن جميع المستخدمين أو المجموعات أو الأفعال. 


الرمز (؟) للتعبير عن الدخول بدون اسم وفي هذه الحالة يتم إعداد 115 لاستخدام الدخول بدون اسم ( لا يمكن 
استخدام هذا الرمز إلا في الواصفة كإعولا.) 


تتم معالجة سلسة عناصر <س0ااه> و<رطعل> من الأعلى إلى الأسفل ويستمر حتى في حال إيجاد تطابق 
معين للحصول على أفضل تطابق. 


تعطى العناصر <ردءل> الأولوية على العناصر <سهااه> . 
مثال: 
<configuration>‏ 


<system.web> 

<authorization > 

<allow roles="MyDomainName\SalesDept" 
users="MyDomainName\sami,MyMachineName\adel" /> 
<deny users="*" /> 

</authorization > 

</system.web> 


</configuration> 
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سوف يسمح الملف التالي للحساب نصهء من عصNN2منه‏ 00ر(" والحساب المحلي 1ءله إضافة إلى جميع 
المستخدمين من المجمو عة م0(ءء[ه5 بالوصول إلى التطبيق ويحجب باقي المستخدمين. 


تحدید نمط الوصول في 1۲۲۲ 


يمكن أيضا باستخدام عناصر <wسهالة>‏ و<رعل> التحكم بنمط الوصول باستخدام 11۲۴ باستعمال 
الواصفة ط۷6۲ كما في المثال التالي: 


<configuration> 


<system.web> 

<authorization > 

<allow verb="GET" users="*" /> 

<allow verb="POST" users="MyDomainName\marthasmith" /> 
<deny verb="POST" users="*" /> 

</authorization > 

</system.web> 


</configuration> 
أما في حال الرغبة بإعداد سماحيات الوصول لأكثر من مجلد فرعي أو ملف باستخدام نفس ملف‎ 
نستخدم العنصر <١٥1)ةءه[> وذلك كما في المثال:‎ web.con 1g 


<configuration> 


<system.web> <!-- default for this application --> 
<authorization > 

<allow verb="GET" users="*" /> 

<allow verb="POST" users="MyDomainName\marthasmith" /> 
<deny verb="POST" users="*" /> 

</ authorization > 

</system.web> 

<location path ="mypage.aspx"> <!-- only applies to this file --> 
<system.web> 

<authorization > 

<allow verb="GET" users="*" /> 

<allow verb="POST" users="MyDomainName\billjones" /> 
<deny verb="POST" users="*" /> 

</ authorization > 

</system.web> 

</location > 


</configuration> 


يمکن أن نوجه ۸5۴.۴1 لاستخدام حساب معين بدلا من الحساب الذي تم التحقق منه من قبل 118 عن 
طريق العنصر <رإأ1) >1١‏ وذلك كمابلي: 


<configuration> 
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<system.web> 

<identity impersonate="true" 
userName="MyDomainName\MyUserName 
password="MyPassword" /> 
</system.web> 


</configuration> 


إعدادات sس‏ لم1 و 1S‏ لحالة التحقق من الهوية باستخدام Windows‏ 


ذکرنا أن الوصول باستخدام Ww”‏ لم۷“ یعتمد علی حسابات ws‏ ٥لہ۷‏ المتوفرۃ ل ۸8۲.6٤‏ لتتمكر 
من استخدامها للوصول إلى المصادر. 


يوضح الشكل التالي آي الحسابات يتم استخدامه للوصول إلى المصادر لتقوم بإعطاء هذا الحساب السماحيات 
المناسبة: 


cperifring anı aczeunt j Sê pêr mëšionš 
within he «Identiyz fur the specified 
sêlton î ın under? | : alot 


Arif CESS Ling identity 
enabled in IS? imparsonate= "jz" x? 


Set permiszjbrrs 
fur ASPNET prazes 
acount 


Laing Rertitg 
impart sonale= "fe" fa? 


Tle cormınmor 
Scenario! 


Spacing aî acount Set permizsicres for indiriduıal LET atu 
within he <identiîy> that ê, accounts cluded in sauthorizaton> 
section ta nn urder? section <alowz™ elements} 


Ta FANE ACCESS O ACTOS USBFS 
[not required in a secured applîcatir] 
iclhude 'F mM Augers™ and şet 
permizsions For MER IIS} agent 


Set per mBsicrs 
for he specifi 
account 


ترجمة الشكل 


Anonymous Access Enabled in في هل يُسمح بالدخول المجهول الهوية‎ 
IIS? 
IIS 


Using <identity استخدام‎ مت>i‎ entity 


1impersonate=” True” />? : , 
P impersonate=” True” /> 


Specifying an account within the <لاا ٣6ل ن>تم تحديد حساب ضمن الة‎ 
<identity> section to run under 
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تعيين السماحيات للحساب المحدد 


تعيين السماحيات لحساب الإجراء 
ASPNET‏ 
تعيين السماحيات للحسابات المفردة أي 
الحسابات المضمنة في القسم 
من العنصر <authorizat10¬>‏ 
<allow>‏ 
للسماح بالدخول المجهول الهوية (غير 


Set permissions for the specified 
account 
Set permissions for ASPNET 
process account 


Set permissions for individual 
user accounts , that is accounts 
included in <authorization> 
section <allow> element 


To grant access to anonymous 


users (not required in a secured 
application) include °?’ in 
permission for IUSER (IIS) 
account 


مطلوب في تطبيق آمن) يجب تضمين 
ازمر اا فى اماف ا 
[SER‏ [ المسمی 118 

The common scenario الحالة الأكثر شيوعاً‎ 

Yes نعم‎ 
No کلا‎ 


مراحل تسجيل الدخول في تحقق الهوية ”0لم ۷“: 


ET arê not authorized to ببعاپ‎ this page = Microsoft Int ernekt Explorer 
| Fle Edt View Favorites Tools ap 


| vek -.=» Q3 A) Qam Girone gnaw S-323. 


| Addrezs a httpiffdandare zecure-mîndors] آ=‎ Co | [ete 2 


Enter Network Password 


2 Fleasê pê your ute HaîhE arid patêwotd. 
Sile: danlare 


ser Name | 


د د 


Passmond 


Domain [primase 


[7 Save his passed in yet pazsword Et 

| س 
ا 

lB]Dore [| | EElocalrkrenet 2 
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(ou are not authorized to view this page Microsoft Internet Explorer _ 

J Filê Edt View Favorkes Tools Help 

| Bak - + <Q Û | QSeeh GHFwvates nso HA” 3ã O ~3 

| Adiess |&] hitp:ffdandarejsecure-windorss| أ“‎ a) | ا‎ 8 


You are not authorized to view this page 


Teu do not have permission to wiew this directory or page using the 
credentials you supplied. 


Please try the following! 


» Click the Refresh button ta try again with different 
credentials, 

®» If you believe foi should be able to viawe this directory ûr 
page, please contact the Web sîte administrator by using the 
e-mail address or phone number listed on the dandars horne 
page. 


HTTF 401.1 * Unauthorized: Logon Failed 
Internet Informati ari Services 


lejboone 


۳ Fle Edt EE Favorkes TT ES 
| Est . #» - - 3 3 A Aen [EJ Favorites History | hr a8- ك‎ 
| Rrezs |€] hrtpıl{dandere|secure-nindons! 


Server error in /secure-windows application. 


Access i5 denied, 


Description: An error occurred while ac5EeSsing the resources required lû Serve this request, The server 
rray nol bê configured tor actêš3 to hê reqiešlêed URL. 


Error message 401.2.: Access is denied because of the WYeb server's configuration. Contact the Yel 
server's adınirisiralor for help. 


التحقق من الهوية من النمط 7١١إ0مءئو۶“‏ 


يقدم استخدام التحقق من الهوية الخاص ب sسهلمW1‏ طريقة آمنة وجيدة للتحكم بالوصول باستخدام 
P.۴۳1‏ لکن تبرز مشکلته حين نريد استعمال سياسة استخدام توقيع وحيد لأكثر من تطبيق على أكثر 
من مخدم أو موقع بالأخص إذا كانت متباعدة جغرافياً. يكمن الحل الوحيد في تعريف نفس الحساب على جميع 
المخدمات أو باستخدام '٤6إ٥۴'‏ مع Active Directory‏ بحیث تکون جمیع المخدمات جزء من نفس 
المؤسسة حتى لو كانت في نطاقات مختلفة. 
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ولكن هذا الحل يفشل في الحالة التي يكون مطلوباً فيها التحقق من الهوية على أكثر من موقع . كما هي الحال 
إذا أردنا السماح بالوصول بشكل آلي إلى موقعنا في حال نجح المستخدم بالوصول موقع معروف مثل 


. Hotmail 


يمكن إتمام هذه العملية باستخدام التحقق من الهوية من النمط 01۲صءئھ۴“ حیث تقدم شرSة Microsoft‏ 
خدمة تسمى S6۲۷1٥۴7”‏ ٣0۲مءيهة۶“‏ يمكن استخدامها للتحقق من هوية المستخدمين على آي موقع يدعم هذه 
الخاصنية. وذلك اعتباراً من أي مكان على الانثرنت. 


عند تسجيل الدخول على موقع يدعم هذه الخدمة يقوم المستعرض بإرسال المعلومات إلى خدمة ٤0۲مsیPa‏ 
التي تقوم بالتحقق من الهوية وتقوم بوضع كعكة على الجهاز . 


عندما يحاول المستخدم الوصول إلى موقع آخر يدعم هذه الخدمة يقوم المستغرض بإظهار. الكعكة إلى خذمة 
sp‏ متبتا أنه قد تم التحقق من هويته. 


استخدام خدمة ١0۲مءء۴2‏ غير مجاني ولابد من التسجيل للحصول على هذه الخدمة وتتبيت برنامج خاص 
على مخدم الوب لتفعيل عمل هذه الخدمة. 


بعد عملية التسجيل والإعداد يمكننا ضبط هذا ضمن الملف عاگweb.con‏ 


<configuration> 


<system.web> 

<authentication mode="Passport"> 
<passport redirectUrl="internal | url" /> 
</authentication > 

</system.web> 


</configuration> 
يدعم العنصر <ا0۲مءءةم> واصفة وحيدة هي ]۸ 0١١1۲ء۲ تحدد المحدد القياسي للصفحة التي سيتم‎ 


التوجه إليها في حال فشل التحقق من الهوية. تكون هذه القيمة معينة تلقائياً قبل تثبيت خدمة ١0۲مءءه۴‏ إلى 
القيمة “Internal”‏ . 
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عند تفعيل خدمة 0۲۲7مءء۶2“ يكون إجراء تسجيل الدخول على المخدم كالتالي: 

يقوم المستخدم بطلب مصدر ما من المخدم 

٠‏ إذا كان هذه المستخدم قد سجل دخوله إلى خدمة ١0۲مءءه۴‏ سيكون لديه بطاقة مشفرة ضمن كعكة 
وسيقوم المخدم بالوصول إلى خدمة ١0۲مءءه۴‏ للتعرف على هوية المستخدم 

٠‏ في حال عدم توفر البطاقة المشفرة والمخزنة في كعكة أو في حال انتهاء صلاحيتها يتم إرسال المستخدم 
إلى صفحة تسجيل الدخول الخاصة بخدمة )0۲مPass‏ 

يقوم المستخدم بتسجيل الدخول 

٠‏ في حال تم التحقق من هويته يتم إعادة تحويله إلى مخدم التطبيق مع البطاقة المعرفة عنه ليتم تخزينها 
ككعكة على جهاز المستخدم 


التحقق من الهوية المبني على النماذج 


يناسب هذا النوع من التحقق من الحالات التي لا تكون فيها الدرجة المطلوبة من الأمان عالية ( أحياناً يشار 
إلى التحقق من الهوية المبني على النماذج بالتحقق المبني على الكعكات). 

الجديد في ۸8۲.٤٣‏ فيما يتعلق بهذه الطريقة هو أنه تمت أتمتة العديد من العمليات التي كنا نضطر للقيام 
بها برمجياً عند العمل مع النسخة السابقة )A8۴(‏ . 

لن نعود مضطرين بهذه الطريفة للمحافظةطلى الشكل. الوحيد لشاشة تنجيل الذخول (شاشة تسجيل اللخول 


الخاصة بكس 0ل"۷1) بل يمكننا استبدالها بأي نموذج مخصص جذاب. 


يشر ح الشكل التالي يشرح إجراء التحقق من الهوية عن طريق النماذج. 
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Redirêcl usêr 
to login form pağê 


User submits 


Request | Authenticate and EEN 


4 
6 
AULROIZE USêF ا‎ 
OK 5 


l5 althenlicêtlûn 
cookie presanl ' Na 
in headers? 


credentials 
E5 ASP.NET تا‎ 
Althêfiticatê Fall) 
غلا‎ e i 
Send rêsoufcê ESTEE 
to client dt Add cookie 5 
_ asl— is aU narize to ta HGS ۸ 
ACCESS fESOURCE 
Elia 
تر : أل ك‎ 
Request طلت‎ 
Authenticate and authorize user التحقق من هوية المستخدم ومنحه‎ 


هل تتضمن ترويسة الطلب الكعكة الخاصة 
بالتحقق من الهوية 
إعادة توجيه المستخدم إلى صفحة نموذج 
تسجيل الدخول 
يرسل المستخدم معلومات التسجيل 
التحقق من هوية المستخدم 
إضافة الكعكة إلى ترويسة الطلب 
التأكد السماحية للمستخدم بالوصول إلى 
المورد 
إرسال المورد إلى الزبون 
نعم 
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Is authentication cookie present in 
header 


Redirect user to login form page 


User Submit credentials 
Authenticate user 
Add cookie to header 
Check if user is authorized to 
access resource 
Send resource to client 


Yes 
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No 
Fail 
Denied 


E 


ممنو ع 


بعد أن يتم التحقق من الهوية في 118 يتجه الطلب إلى ۸5۴.٤٣‏ حيث يتم التأكد من احتواء ترويسة الطلب 
للكعكة. 


يتم توليد الكعكة إذا سبق للمستخدم الوصول إلى التطبيق . أما إذا كانت الكعكة غير متوفرة فمعناه أن هذا 
المستخدم لم يسجل الدخول إلى التطبيق مسبقا أو أن صلاحية الكعكة انتهت وبالتالي لابد من توجيه المستخدم 
إلى نموذج تسجيل دخول مخصص. يدخل المستخدم معلومات اسم الدخول وكلمة السرء ويقوم بإرسال 
المعلومات إلى التطبيق حيث يتم التحقق منها وإنشاء كعكة وإضافتها إلى ترويسة الطلب وإرسال الطلب إلى 
المرحلة التالية حيث سيتم التأكد من سماحية وصول المستخدم إلى المصدر المطلوب . 


إعداد التحقق من الهوية المبني على النماذج 


يتم إعداد التحقق المبني على التماذج عن طريق الملف ياگدهء.طاeس‏ أيضاً ضمن القسم 
>authenticati10n<‏ وذلك بالشكل : 


<configuration> 


<system.web> 

<authentication mode="Forms"> 

<forms name="cookie-name" 

path ="cookie-path" 

loginurl="url" 
protection="All| None| Encryption | Validation" 
timeout="number-of-minutes" > 

<credentials passwordFormat="Clear|SHA1 |MDS"> 
<user name="user-name" password="user-password" /> 
<user name="user-name" password="user-password" /> 
... more users listed here ... 

</credentials> 

</forms> 

</authentication > 

<machineKey validationKey="AutoGenerate| key" 
decryptionKey="AutoGenerate | key" 
validation="SHA1|MD5"/> 

</system.web> 


</configuration> 
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" معmصهN‏ يمثل اسم الكعكة 
اه۴ يمثل المسار الذي تكون الكعكة فعالة من أجله (عادة نستخدم "/') للتعبير عن كون الكعكة فعالة 
لكامل الموقع. 
ااu_ماعه[‏ تحدد المسار للوصول إلى صفحة تسجيل الدخول. 
Protection "‏ تحدد درجة الأمان المطلوبة للكعكة : 
ه لالقيمة ۸11 يتم استخدام تشفير مبني على العنصر <رع)kعinطcھص>‏ وتشفیر D٤S(‏ ماما٣‏ ا) إذا 
كان طول المفتاح أكبر من 48 بايت. 
ه القيمة "0٥٥‏ فلا يتم التشفير . 
ه القيمة ١٥0ذامرإء"8‏ يتم تشفير الكعكة ولكن لا تتم عملية التحقق من البيانات. 
ه Valid ati0n‏ تتم عملية التحقق من البيانات ولا تتم عملية تشفير الكعكة. 
" عص تحدد بالدقائق الوقت اللازم للكعكة لتنتهي صلاحيتها. 
يمكن استخدام العنصر <ءاها٤١ءلعء>‏ لتحديد خوارزمية التشفير المستخدمة لتشفير كلمة السر في 
ملف عاگصهء.اعس يمكن ضمن هذا العنصر إيجاد مجموعة من عناصر <۲عءنا> التب تحدد المستخدمين 
القادرين على الوصول إلى المصادر المحمية. 
یمکننا أيضا تحديد عنصر <لعK)ع«نطءهم>‏ الذي يحدد المفاتيح وطريقة التشفير التي ستستخدم لتشفير 
و ا 


القيمة التلقائية لهذا العنصر ستكون من الشكل : 
<machineKey validationKey="AutoGenerate"‏ 


decryptionKey="AutoGenerate" 
validation="SHA1" /> 


إعداد التحقق من الهوية المبني على النماذج 


مثال على ما سيبدو عليه الملف عاگ«هء.طءس في حالة تحقق الهوية المبني على النماذج: 


<configuration> 


<system.web> 

<authentication mode="Forms"> 

<forms name="MyNewApp" path="/" loginUrl="/main/login.aspx" 
protection="All" timeout="30" > 
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<credentials passwordFormat="SHA1"> 

<user name="billjones" 
password="87F8SED9157125FFC4DA9EO6A7B8011AD8OA53FE1" /> 
<user name="marthasmith" 
password="93FB8A49CC350BAEB2661FASCS5C97959BD328C50" /> 
<user name="joesoap" 
password="5469541CA9236F939D889B2B465F9B15A09149E4" /> 
</credentials> 

</forms> 

</authentication > 

<!-- keys usually only specified for a Web farm --> 

<machineKey validationKey="3875f9...645a78ff" 
decryptionKey="3875f9...645a78ff" 

validation="SHA1" /> 

</system.web> 


</configuration> 


إنشاء نموذج تسجيل الدخول: 
بعد إعداد الملف عاگ«هء.ط6س لابد من العمل على إنشاء النموذج الخاص بتسجيل الدخول. 


فيما بلي النص البرمجي لمثال بسيط عن مثل هذا النموذج: 
<%@Page Language="VB" %>‏ 
<html>‏ 
<body>‏ 
<form runat="server">‏ 
UserName: <input id="txtUsr" type="text" runat="server" /><p />‏ 
Password: <input id="txtPwd" type="password" runat="server" /><p />‏ 
<ASP:CheckBox id="chkPersist" runat="server" />‏ 
Remember my credentials<p />‏ 
<input type="submit" value="Login" runat="server"‏ 
onserverclick="DoLogin" />‏ 
<div id="outMessage" runat="server" />‏ 
</form>‏ 
</body>‏ 
</html>‏ 


نتيجة النص البرمجي ستكون كمايلي 
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http: dandare,/ 4885, security #forms-based/login.aspx - ... FI]‏ ا2 
Î Fils Edit Yimw Favorites Tools Help EH‏ 


Î 4 Bark = =) <+ 3 il i Search [#] Favorites A HEtary 3 


| 55 8 hEtp iff dandare/4885 security f fForms-basedflogin, aspx >| 6 
\serMarme: [ahomer 


Password: [۳ ف‎ 


¥ Remember my credentials 


Invalid credentials please re-enter... =| 


ww 
3 Done 2 Local intranet 9 


إعداد التحقق من الهوية المبني على النماذج 


كتابة النص البرمجي لتسجيل الدخول: 


بالرغم من كون تحقق الهوية المبني على النماذج تقنية ذكية ولكنها لن تستطيع القيام بكل شيء آليا إذ لا بد لنا 


من كتابة نص برمجي لأداء بعض العمليات المطلوبة . 


تنتمي جميع الصفوف التي تستخدم في İaمjı ASP.NET‏ إلى فۈضlءs‏ lأln«ء System.Web.Security‏ . 


ويدعى الصف الذي يتولى مواضيع التحقق من الهوية باستخدام النماذج FormsAuthentic2)10۸‏ . يقدم ھذا 


الصف مجموعة من الطرق و الخصائص أهمها: 


Authenticate 
web.config .لف‎ 
تقوم بأداء جميع الأعمال المطلوبة (بعد التحقق من الهوية) من‎ 
redirectFormL 
١ انشساء للکعکة و اضافتھا الے, د ة الطلى و ار سال الطلف‎ 
و فتها لی درويسه ۰ ي ل ۰ ال‎ ۶ ٤ oginPage 


SetAuthCookie 


245 


تقوم باختبار اسم المستخدم وكلمة المرور ومطابقتها لتلك المعدة في 


الصفحة التي تمت محاولة الوصول إليها أصلا . 
SignOut‏ تدمر الكعكة المشفرة بالتالي تقوم بعملية تسجيل خروج المستخدم. 
إنشاء الكعكة المشفرة وتضيفها إلى ترويسة الطلب ولكن لا تقوم 
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تقوم بإعادة قيمة الكعكة دون إضافتها إلى ترويسة الاستجابة. هذه 
GetAuthCookie‏ 

الطريقة مفيدة عندما نريد القيام بتخصيص للكعكة قبل تصديرها. 

تعيد محدد المصدر للصفحة التى طلبها المستخدم قبل توجيهه ! 
GetRedirectUrl‏ لی 

صفح تسل اتخون 


إذا يمكننا استخدام هذه الطرق بإضافة النص التالي إلى نصنا البرمجي: 


Sub DoLogin(objSender As Object, objArgs As EventArgs) 

If FormsAuthentication.Authenticate(txtUsr.Value, txtPwd.Value) Then 
FormsAuthentication. RedirectFromLoginPage(txtUsr.Value, _ 
chkPersist.Checked) 

Else 

outMessage.InnerHtml = "<b>Invalid credentials</b> please re-enter." 
End If 

End Sub 


إعداد التحقق من الهوية المبني على النماذج 


إلى متى تظل الجلسة فعالة: 
تعتبر مدة فعالية الكعكة أحد النقاط الهامة التي يجب الانتباه إليها. 


تكون المدة التلقائية لصلاحية الكعكة 30 دقيقة إذا لم يتم تعديلها من خلال ضبط قيمة الواصفة اعا 
ضمن العنصر <كطإه> في الملف عاگweb.conf‏ . 


يتم إنهاء صلاحية الكعكة أيضاً عند إغلاق تطبيق المستعرض. بالطبع سوف يتم تحديث الكعكة مع كل 
اة من مى اة اها + ذلك يسه الزمن هن أخر وصرل إلى السقحة: 


تقدم ۸AS۴.N٤۲‏ خيار الإبقاء على الكعكة بين الجلسات. فعند استدعاء الطريقة 
Redirect FromLoginPage‏ نقوم بتحديد قيمة منطقية للمعامل الثاني الذي تأخذه هذه الطريقة وهو في 
مثالنا السابق قيمة الخاصة dعء)ءعطC‏ لعنصر التحكم ×0طا)ءعطء على صفحة تسجيل الدخول: 


FormsAuthentication. RedirectFromLoginPage(username, persist-cookie) 


عند تمرير القيمة 1٠٠#‏ يتم إنشاء كعكة تملك زمن صلاحية طويل جداً (50 عاماً) مما يسمح للمستخدم بعدم 
الأقظرار إلى تسجيل الذخرل مجتذدا. 
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تقوم أغلب المستعرضات الحديثة بتخزين الكعكات على أساس المستخدم مما يشكل مشكلة أمنية لأنه من 
السهل اختطاف كعكة وبالتالي سوف يتمتع الخاطف بالوصول إلى الموقع خلال فترة حياة الكعكة. لذلك يفضل 
عدم تطبيق هذا السيناريو إلى في الحالات التي لا تتطلب أمن عالي. 


على أي حال نستطيع ضمان تدمير الكعكة قسرياً باستخدام الطريقة اا0 ع1؟: 
FormsAuthentication.SignOut() |‏ 


لكن هذه الطريقة غير قادرة على اكتشاف كعكة مسروقة وتدميرهاء لذلك يجب الابتعاد عن استخدام الكعكات 
دات العفو الطويل : 


إعداد السماحيات للأمان المبني على النماذج 


تكلمنا حتى الآن عن التحقق من الهوية المبني على النماذج لكننا لم نحدد ما هي المصادر التي يسمح 
للمستخدمين بالوصول إليها. يمكن إضافة القسم ٣<‏ ٥ا۲ہ‏ طاںھ> إلى الملف عاگوہء. ط۵س وإلا سیتم 
تطبيق السماحيات التلقائية المحددة في الملف عاگمهء.ع«ذطعه. والذي يحتوي فيه القسم 
>authorization<‏ ما يلي : 

<authorization > 


<allow users="*" /> 
</authorization > 


لذلك وللسماح فقط لمجموعة معينة من المستخدمين بالدخول نكتب في الملف :عb.c0«۴1عمسw‏ 


<configuration> 


<system.web> 

<authorization > 

<allow users="billjones,marthasmith,joesoap" verb="GET" /> 
<allow users="marthasmith" verb="POST" /> 

<deny users="?" /> 

</authorization > 

</system.web> 


</configuration> 
<authorization > 
<deny users="?" /> 
</ authorization > 
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يجب ألا نتحمس لتطبيق سماحيات ۸٣1‏ الخاصة ب sس0لم۷‏ على الموارد» فحتى لو كان هؤلاء 
المستخدمين معرفين في sسهلم۷1‏ وتم ضبط سماحيات لهم فلن يتم استخدام أي من هذه الحسابات عند 
استخدام التحقق من الهوية المبني على النماذج. 


يصبح من الصعب مع عدد كبير من المستخدمين» التعديل يدوياً على المستخدمين ضمن القسم 
>credentials>‏ من الملف عاگمصco. web‏ لذا نحتاج لا لتخزين هذه المعلومات في مكان آخر أو في ملف 
XM‏ أو قاعدة بیانات أو حتى في ۷اهاءم1۲ 4)۷۵ ولا بد عندها من تطوير آلية المقارنة بين 
المعلومات المدخلة في نموذج تسجيل الدخول وما هو موجود ضمن قاعدة البيانات أو في ملف ۷1× وذلك 
باستخدام التقنيات التي تعرفنا عليها في الجز ء الخاص بالاتصال بمصادر البيانات المختلفة. 


+ 


خاتمة 
لاحظنا من خلال ما اطلعنا عليه حتى الآن تركيزنا على التحكم بالوصول إلى المصادر بالاعتماد على مبداً 


التعرف بصورة فردية على المستخدم باستخدام تحقق الهوية ثم التأكد من سماحيات المستخدم للمصادر 
المحددة . 


لكن هناك بعض الحالات التي نحتاج فيها إلى تحديد اسم المستخدم المصرح له بالدخول من خلال النص 
البرمجي. يتم أداء تلك العمليات باستخدام مجموعة من الأغراض منها إعءل , اجمذم1۴. فيما يلي بعض 
العمليات التي نستطيع القيام بها. 


لاستعادة اسم المستخدم يمكننا استخدام الكائن إعءلا 


strUserName = User.Identity.Name 


لتحديد كون تحقق الهوية قد تم بنجاح نستخدم lلخاصة IsAuthenticated‏ 
binAuthenticated = User.Identity.IsAuthenticated‏ 


و لتحديد نوع تحقق الهوية المعتمد نستخدم 
strAuthType = User.Identity.Authentication Type‏ 
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و في حال كان نوع التحقق من الهوية المستخدم هو sس0ل,۷1‏ يمكننا تحديد فيما إذا كان المستخدم ينتمي 


إلى مجمو عة محددة باستخدام الطريقة عإهRم1ء1‏ 
binResult = User.IsInRole("MyDomainName\SalesDept")‏ 


الفصل السابع عشر 
رن اتروع 
تطبيقات الوب في ٤٥١.صءه‏ و ملفات التهيئة. 


الكلمات المفتاحية: 


أنظر ال رrهءوها6‏ المرفق 


ملخض : 
طورت ۸8۴.٤۲‏ مفهوم تطبيقات الوب و ضمنته الكثير من المزايا كما قدمت آليات أكثر مرونة في ضبط إعدادات ملفات 
التهيئة. 


ضمن هذه الجلسة سنقوم بالتعرف تطبيقات الوب و كيفية إنشاءها وتنسيق ملفات التهيئة وكيفية الاستفادة مذ 
صمں سدفوم مهوم و ونديى و و ي 
أهداف تعليمية: 


يتعرف الطالب في هذا الفصل على: 
. كيفية إنشاء مجلدات التطبيقات و تسجيل المكونات 
٠‏ بنية التطبيق و الملفات الأساسية 
نiiسيق‏ الف GLOBAL.ASAX‏ 
ه٠‏ ننسيق ملفات التهيئة وكيفية الاستفادة منها 

تطبيقات الوب في ۸5۶.٤٣‏ و الملف ×هیھ.اھعہاع 
دعمت نسخة 450 مبدأً تطبيقات الوب حيث أنها كانت على شكل مجموعة من ملفات 50ه. إضافة إلى ملف باسم 
global.asa‏ . 
قامت ۸5.۸6 بتوسیع هذا المفهوم و أضافت مصادر أخری کصفحات ۸8۴.٤۲‏ و خدمات الوب › عناصر التحكم 
الخاصة بالمستخدم » وملف إعداد البيانات و الملف ×ه5ه.اجطه‌ان و ملفات أخرى عديدة تم إنشاؤها إما من قبل المستخدم 
أو مضمنة في ۸8۲.6٤‏ . 
ضمن هذه الجلسة سنقوم بالتعرف على مفهوم تطبيقات الوب و كيفية إنشاءها و تنسيق الملف ×ه5ه.اجطه‌ان و الملفات 
machine.config web.config‏ و کیفیة الاستفادة منها. 
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تطبيقات الوب كيف نبدأً 


عرفنا في جلسات سابقة المجلدات الافتراضية و ذكرنا فوائدها ورأينا كيف بإمكاننا إنشاء مجلد افتراضي 


في ۱|8 . 


الآن و بفرض أن لدينا مجلد افتراضي كيف سنقوم بتحويل هذا المجلد إلى تطبيق وب ؟ 
يمكننا ببساطة أن ننقر بالزر الأيمن على المجلد الافتراضي نختار الخيار 6اا 6م٥۴۲‏ عندها ستظهر 
شاشة كما في الشكل إلى اليمين: 


E 


Directoy | Documents | Directory Security | HTTP Headers | Custom Errors | 
when connecting ta this resource, the content should come from: 
{® The designated directory 
û share located or another cori puke 
f A redirection to a URL 


Local Fath: [wrox 


rox Properties 


Wronu Properties 


Directory Documents | Directoy Security | HTTP Headers | Custom Errors | 
when connecting to this resource, the content should come fram: 
fF The designated directory 
f A share located or another computer 
fT A redirection to a URL 


Local Path: [iskiest 


FT Script source access IW Log visits T Script source access IW Log visits 
FW Read IF Index this resource ¥ Read ¥ Index this resource 
U Write TT Wile 


FT Directory browsing FT Directory browsing 


Application Settings 


Application name: HE 


Starting point: ¢Default web Site Wrox 


Execute Permissions: Scripts only ا‎ 
Application Protection: [Medium [Pooled] ا‎ Ulaad | 


Application Settings 


Default Applization 


Create 


Borliquralun... 


Applicator hane: 


Starting point: ¢Default Web Sites 


Execute Permissions: Scripts only "[ 
Application Fiotectiof: [tedium (Pooled) آ*‎ LEE 


Cancel | را‎ | Help | Ok | Cancel | ام‎ | Help | 


في تلك الشاشة يمكننا رؤية إعدادات المجلد › قيمة الخاصة ۴2۸ اهعم | التي تحدد المسار المحلي »و 
السماحيات المطبقة على هذا المجلد . 

نلاحظ في في حالة شكلنا أعلاه أن السماحياتالمتوفرة هي القراءة و تسجيل الزيارات فقط إضافة إلى تفعيل 
الفهرسة على هذا المورد. 

و في الجزء الأسفل » في القسم المعرف ك و١‏ |اأهء ها iاممA‏ فنلاحظ أنه يمكننا تفعيل صفة تطبيق 
الوب بالنقر على الزر 0۲۴۵8 عندها ستتغير بعض العناصر على النافذة لتصبح كما في الشكل الظاهر على 
اليسار .بعدها يكفي نقر الزر لام۸ لتثبيت التغييرات. 


أما في حال الرغبة بإزالة صفة تطبيق الوب عن المجلد الافتراضي فيكفي نقر الزر 0۷6" ۸6. 


Universal Knowledge Solutions s.a.1 250 


8P. 1‏ ۸ تطبیقات الوب في 


تستخدم ۸8۴.٤1‏ تطبيقات الوب الخاصة ب 118 لتعريف نطاقات خاصة للطبيقات . كل نطاق لتطبيق 
مفصول عن النطاقات الأخرى » آمن و لا يتشارك بالذاكرة مع النطاقات الأخرى. أي لن يتم تشارك بيانات 
مثل «10ویع؟ و «0ناa‌نامم4‏ (و هي بيانات سنتكلم عنها باستفاضة لاحقاً) مع بقية النطاقات . 
عملية الفصل هذه ستجعل من أي خلل في عمل أحد التطبيقات في نطاق ما غير مؤثر و منفصل عن بقية 
التطبيقات. 
تتألف تطبيقات وب ۸5۶.٤٣‏ عادة من ثلاثة أنماط من المصادر التي يمكن للمستخدم إنشاؤها إضافة إلى 
تلك القياسية المبيتة في ۸5۴.٤1‏ و الصفحات و خدمات الوب: 

N‏ هذا المجلد يتوضع مباشرة ضمن المجلد الجذر و يستخدم لاحتواء معلومات المجمعة التي 
تستخدمها التطبيقات. 

×هكه.21طه1اG‏ هذا الملف هو بديل للملف هوه.41ط٥1ع‏ الذي کان مستخدماً مع ۸8۴ و هو يسمح 
بتنفيذ نص برمجي للأحداث في ۸8۴.٤١‏ و إسناد قيم إلى المتغيرات وذلك على مستوى تطبيق الوب 
کاملا. 

:Web.confi‏ يمكن إعطاء إعدادات خاصة لكل تطبيق اعتماداً على مستوى الأمان المطلوب. يمكن 
للإعددات المثبتة في هذا الملف التغطية على الإعددات العامة المعينة في الملف عاكمهء.#«1طعمص الذي 
يحدد الإعددات العامة التي تنطبق على جميع التطبيقات في بيئة ۸8۴.٤1‏ المثبتة على المخدم. 


تسجيل المكونات : 

ا عن الاعتماد على سجلات النظام تعتمد ۸5۶.٤1‏ مجلد خاص هو 81١‏ لتسجیل المكونات کجز ء 
من التطبيق. 

كانت هذه العملية تتم سابقاً (في 48۶) بتسجيل المكونات عن طريق النظام على سبيل المثال كنا نضطر 
لاستخدام الأداة 32.8×۴ E69۷۸‏ ۸# لتسجيل المكونات أو عن طريق +00 من الخيار 

Component Service‏ في خيار الأدوات الإدارية ضمن لوحة التحكم. 
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تطبیقات الوب في آ٤ P۴.‏ ۸5- تسجیل المکونات 


طرح موضو ع استخدام تسجيل المكونات عن طريق النظام مجموعة من التساؤلات حول قابلية النقل بين 
مخدمات متعددة و استبدال المكونات أثناء العمل إضافة إلى موضوع الاضطرار للحصول على سماحية 
الوصول محلياً إلى المخدم لتسجيل المكونات مع عدم إمكانية تشغيل أكثر من نسخة مختلفة من المكون 
لأكثر من تطبيق. 


- تم حل كل تلك المشاكل السابقة في ۸8۴.٤1‏ و أصبح بالإمكان اتمام عمليات التحديث و النقل و 
استخدام أكثر من نسخة من المكون ضمن هذه البيئة. 

- لا تتطلب 81 .N‏ وصول محلي إلى المخدم لتسجيل المكونات. بكل بساطة يكفي نسخ النص المكتوب 
بلغة التجميع إلى المجلد ہ81 حيث يتم شحنها من قبل ۸5۴.٤٣‏ و تصبح متوفرة للاستخدام من قبل 


- لا يوجد سوى مجلد واحد باسم 81١‏ لكل تطبيق و بالتالي لن تون مكونات المسجلة في تطبيق ما إلا 
ا اى 


- لا نحتاج لاستبدال أي مکون في ۸5۲.٤1‏ إلى إيقاف 118 (بعكس )A8۶‏ بكل بساطة يمكن التعديل 
على الملف التجميعي المرتيط بالمكون أو التعديل على التطبيق . 

- تمنح ASP. ٤1‏ هذه الخاصية لأنها تقوم بالتنصت على أية تعديلات على المجلد م8 و ما أن 
تكتشف أي تعديل تقوم فوراً بإنشاء نطاق تطبيق جديد و تبداً بتلقي الطلبات عليه أما بالنسبة إلى نطاق 
التطبيق قبل التعديل فسيتم الانتظار لحين إنهاءه التعامل مع الطلبات الحالية و إزالته بعد ذلك. 


تنسيق الملف ×هءه.امbهاع‏ 


يتبع الملف ×هءه.ا2طه1اع تنسيق مشابه لصفحات ۸8۲.٤1‏ و يأخذ عادة الصيغة العامة التالية: 


الموجهات: 
يدعم ×هءه.21طه1ع تعليمات صفحات N٤1‏ .۸5۶ إضافة إلى تعليمات خاصة تستخدم في ترجمة هذا 
الملف . من أهم التوجيهات التي يدعمها ×هوه.1هطه!1ع التالية: 
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" امم و التي تسمح بتحديد الصف القاعدي الذي سيقوم ×هءه.21ط10ع باستخدامهء 

إضافة إلى أنه يدعم خيار توثيق بسيط. 

هذه الميزات مدعومة من خلال واصفتين inherits laa‏ و .Description‏ 

. تحدد الواصفة ءاأامطم] اسم الصف الذي سيتم استخدامه من قبل ×هءه.1ةطهاع كصف قاعدي 
لجميع المثائل المترجمة من هذا الملف.تفيد هذه الميزة في إضافة طرق أو خصائص إلى ×هكه.ا4طهاع . 


. تحدد الواصفة 10۸موم( وصف بسيط للملف ×هءه.1ھطهاع 


[p0 "‏ يمكن هذا الموجه من استيراد فضاء أسماء لاستخدامه ضمن ×2ه.21طه1ع و يقوم بإعطائنا 
تأهيل كامل لصفوف هذا الفضاء ضمن ×هءه.1هطهاع. 

لاشتخدام الموجه 10۲١‏ يجب ضمان كون الملف التجميعي الحاوي لفضاء الأسماء متوفر. يمكن إضافة 
الملف التجميعي في حال عدم توفره باستخدام الموجه yااص٣إع‌ءءA‏ . 

" ل1اصعءءه يستخدم هذا الموجه لتحديد الملف التجميعي الحاوي على الصفوف التي نود استخدامها في 
تطبيق ۸5۴.٤1‏ . الواصفة الأساسية للموجه راا٣ءءك4‏ هي ۳٥‏ حيث يتم بواستطتها تحديد اسم 
الملف التجميعي. 


يختلف الموجهان 0۲۲م"1 و رااصعءء۸ إذ يعتبر الأول أن الملف التجميعي الحاوي على الصفوف 
المطلوبة متوفر للتطبيق . بينما يخبر الثاني ٣٤N.مء۸‏ أن هناك ملف تجميعي يجب شحنه. 


تنسيق الملف ×هءه.[امbهاع‏ 


التصريح عن النص البرمجي: 
" يتم التصريح عن النص البرمجي في ×هءه.41ط٥1ع‏ كالعادة باستخدام التأشيرة 


كما يمكن استخدام S81‏ (النصوص المدرجة من قبل المخدم) باستخدام التعبير عإدآء«ة# بالشكل: 


حيث تمتل ۴11١‏ المسار إلى الملف اعتماداً على نظام الملفات العادي و 41نا۲ذ۷ المسار إلى الملف عبر 


ستتم إضافة محتوى الملف قبل ترجمته إلى ملف ×هءه.21طهاع. 
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کن اکا ماد هر قي فد اناد ات رى رمات ارف مها ها کن کر فن اف 
×4ءه.41ط10ع في أكثر من تطبيق. 


كذلك يمكننا استخدام التأشيرة <اءعزطه> للتصريح عن أغراض بمجال عمل 101ءوم؟ و 

t7‏ امم . يمكن استخدام هذه التأشيرة لإنشاء ملفات ..٤1‏ تجميعية و أو أغراض K0M‏ محددة 
ڊ .CLSID yi ProgID‏ 

أنواع الأغراض التي يمكن إنشاؤها يمكن تعريفها باستخدام ثلاث واصفات هي: 

ئ .ام و s1dءهاء‏ حيث يمكن استخدام أحد هذه الواصفات فقط ضمن التأشير ة <اءعزط0>. 


نرى في المثال التالي أننا قمنا بتعريف متحول بالاسم ٤3”,‏ ممه“ و الذي يشكل مثيلاً من الصف 
.System.Data.DataSet‏ 

تحدد الواصفة ءم0ء5 في مجال سوف يعمل هذا المتحول و بالتالي تحدد حياة المتحول هل ستكون مرتبطة 
بالتطبيق في حال اخترنا القيمة ”١٥1اةء1اممA“‏ أو بالجلسة الحالية في حال اخترنا ”«0ذووم؟“ . 


التصريح عن النص البرمجي: 

يتم التصريح عن النص البرمجي في global.asax‏ كالعادة باستخدام التأشيرة 

<Script runat=’ server’ > 

كما يمكن استخدام 851 (النصوص المدرجة من قبل المخدم) باستخدام التعبير عi1nc1ud#‏ 

كذلك یمکننا استخدام التأشير <اءعزام> للتصريح عن أغراض بمجاJ Application g Session Jac‏ 
ملفات التهيئة في ASP.NET‏ 

ملفات التهيئة في ۸5۴.٤1‏ هي ملفات نصية مبنية بتنسيق اM××‏ . 

تعطى هذه الملفات الاسم عاگ«هء.اءس . يمكن لهذه الملفات أن تظهر في أي مجلد على مخدم الوب . 

يطبق كل ملف عاادصهء.اءس إعداداته على المجلد الذي يحويه و كل المجلدات الأبناء ضمن هذا المجلد. 

يمكن للإعدادات في المجلدات الأبناء أن تعدل بعض الإعدادات للمجلدات الأباء لها. 

يحدد ملف التهيئة الجذر الإعدادات التي ستطبق على جميع التطبيقات ما لم يتم تجاوزها باستخدام ملفات 
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تقوم ۸8۴.٤1‏ بإعداد 115 بحیٹث یمنع الوصول المباشر لملفات عاگصهء.طاءس للتأكد من أن أحداً لن 
يستطيع الوصول إليها لتعديلها إذا كان لا يملك السماحية المناسبة. 

على سبيل المثال يمكن أن تكون الإعدادات الخاصة بمحدد المصدر القياسي 
http://myServer/myA pplication/mydir/page.aspx‏ مطبقة باستخدام ملفاٽت web.config‏ 
بالترتيب التالي: 

الإعدادات لملف التهيئة الأساسي يطلق على الملف الاسم machine.config‏ 


بالمعلومات الموجودة في الملف:٤١٥إس‏ س ۷سيتم تجاوز هذا الملف بالنسبة للموقع الجذر 
و التي يمكن تجاوز ها بالنسبة لتطبيق معين باستخدام الملف: 
و التي يمكن أن يتم تجاوزها بالنسبة لمجلد ما ضمن تطبيق باستخدام الملف 
إذا وجد الملف عاگصهء.اعس في المجلد الجذر للموقع سيتم تطبيق إعداداته على جميع 
التطبيقات ضمن هذا الموقع. 


ملفات التهيئة في ۸8۲.٤1‏ هي ملفات نصية مبنية بتنسيق 1× . 
تعطى هذه الملفات الاسم عاگصهء.طءس . يمكن لهه الملفات أن تظهر في أي مجلد على مخدم الوب . 
يطبق كل ملف عا؟«هء.طعس إعداداته على المجلد الذي يحويه و كل المجلدات الأبناء ضمن هذا المجلد. 
يمكن للإعدادات في المجلدات الأبناء أن تعدل بعض الإعدادا ت للمجلدات الأباء لها. 


بحذد ملت اة اتير الأعداات ا طق على جب الشات ما ل بت فبار رز ها اكل انات 
تقوم ۸SP.N٤1‏ بإعداد 1158 بحيث يمنع الوصول المباشر لملفات عاگمهء.ط٥س‏ للتأكد من أن أحدأ لن 
او ا 0 کن ق ا 
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أقسام التهيئة و معالجات أقسام التهيئة 


كما ذكرنا فإن ملف عاگمهء.اعءس هو ملف بتنسيق ]۷× يمكنه احتواء مكونات ملفات [۷× القياسية 
بما فيها العناصر و التأشيرات » النصوص ٠»‏ و البيانات . 

یمکن أن یکون ترمیز الملف N51‏ ۸ أو 0۴-8 أو ململ حیث یکتشف النظام ذلك تلقائياً. 

العنصر الجذر لملف عاگرهء.اء۷ هو التأشيرة <« 10اةإاعiگصهء>‏ حيث يأخذ محتوى هذا الملف الشكل 
<configuration>‏ 


<!- Configuration settings would go here. --> 
</configuration> 


تحتوي التأشيرة <«10٤ة»اعiگ«هء>‏ على ثلاث أنواع من العناصر. 
٠‏ التصريحات عن معالجات أقسام التهيئة 

٠‏ مجموعات أقسام التهيئة 

٠‏ إعدادات أقسام التهيئة 


معالجات أقسام التهيئة: 

لا تضع ۸8۲.٤1‏ أي افتراضات ضمن ملف عادهء. اس فيما يتعلق بتنسيق الملف أو الإعدادات 
المدعومة ضمنه. عوضاً عن ذلك تقوم بتوكيل معالجة بيانات الملف عاگ«هء.طاeس‏ إلى معالجات أقسام 
التهيئة » و هي صفوف ضمن إطار عمل ..٤1‏ التي تستخدم الواجهة البينية 
IConfigurationSectionHandler‏ . 

لا بد من التصريح عن هذا الصف على الأقل ضمن الملف الأساسي عاگدصهء.٥«نطعوص‏ حيت يتم وراثة 
دعم هذا الصف في جميع المجلدات الفرعية. 

يتم التصريح عن هذه المعالجات ضمن ملف عاگمهء. طس باستخدام التأشير ة <«0ناءم؟عاگصهء> يمكن 
أن يتم تنسيق الأقسام ضمن مجمو عات منطقية باستخدام مجموعات الأقسام . 

كل قسم في الملف عاگصهء.اعس يحتوي معلومات التهيئة إضافة إلى متيل عن الصف 
ection Handler‏ 0nfigurationل]‏ لیقوم بمعالجته. 


أقسام التهيئة و معالجات أقسام التهيئة 


مجموعات أقسام التهيئة: 

توفر ۸5۴.٤١‏ إمكانية التجميع ببنية هرمية للأقسام لأغراض تنظيمية فقط . يمكن أن تظهر التأشيرة 
>Section Grou p>‏ ضمن التأشير ة < ”10†ءSeعiگ«co>‏ أو ضمن تأشيرة <pلا101610اءمء>أخرى.‏ 
على سبيل المثال تظهر جميع معالجات الأقسام ضمن مجمو عة الأقسام <طعW.ع)8ل؟>‏ . 
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أقسام التهيئة : 

توضع الإعدادات الخاصة بالتهيئة ضمن تأشيرات الأقسام . 

لا بد من وجود معالج قسم معرف لكل قسم . على سبيل المثال التأشيرة <ءع ال0 م])ا[> تحدد 
الإعدادات الخاصة بالوحدات انمطية لH]۲۲۶‏ و کک لے اف 
System.Configuration. Http ModulesConfigurationHandler‏ عملیة تفسیر المحتوی ضمن 
التأشير ة <httpModules>‏ . 

يجب الملاحظة هنا أنه يجب أن يكون لمعالج القسم و الفسم نفس مجموعة القسم. 

كذلك لا بد من الانتباه بأن الأسماء للتأشيرات حساسة لنمط الأحرف (كبيرة صغيرة). 

مثال: 


<configuration> 


<configSections> 
<sectionGroup name="system.web"> 
<section 
name="httpModules" 
type="System.Web.Configuration. Http ModulesConfigurationHandler,System. Web" 
/< 
</sectionGroup> 
</configSections> 


<system.web> 
<httpModules> 
<add 
name="CookielessSession" 
type="System. Web.SessionState.CookielessSessionModule,System. Web" 
/< 
<add 
name="OutputCache" 
type="System.Web.Caching.OutputCacheModule,System. Web" 
/< 
<add 
name="Session" 
type="System. Web.SessionState.SessionStateModule,System. Web" 
/< 
<add 
name="WindowsAuthentication" 
type="System. Web.Security. WindowsAuthenticationModule,System. Web" 
/< 
<add 
name="FormsAuthentication" 
type="System. Web.Security.FormsAuthenticationModule,System. Web" 
/<> 
<add 
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مجموعات أقسام التهيئة: 

توفر ۸5۴.٤1‏ إمكانية التجميع ببنية هرمية للأقسام لأغراض تنظيمية فقط . يمكن أن تظهر التأشيرة 
>Section Grou p>‏ ضمن التأشیر ة <؟«ص0نiا›e؟عiگ«ەء>‏ أو ضمن تأشیر ة <م ل۸6۲0 10اءمء>أخرى. 
على سبيل المثال تظهر جميع معالجات الأقسام ضمن مجمو عة الأقسام <طع10.Wع)ء؟>‏ . 


أقسام التهيئة : 

توضع الإعدادات الخاصة بالتهيئة ضمن تأشيرات الأقسام . 

لا بد من وجود معالج قسم معرف لكل قسم . على سبيل المثال التأشيرة <ءعاu‏ ل۷0 م]ط> تحدد 
الاغدكات االخاصة بالوخات االتفطية .ل٥11‏ ف الى الف 
System.Configuration. Http ModulesConfigurationHandler‏ عملية تفسیر المحتوی ضمن 
التأشير ة <httpModules>‏ . 

يجب الملاحظة هنا أنه يجب أن يكون لمعالج القسم و الفسم نفس مجموعة القسم. 

كذلك لا بد من الانتباه بأن الأسماء للتأشيرات حساسة لنمط الأحرف . 


استخدام الموقع و المسار 
كما ذكرنا يتم بشكل تلقائي توريث جميع الإعدادات الخاصة بالتهيئة إلى المجلد الذي يوجد فيه و جميع 
المجلدات الفرعية ضمنه. 
يمكن تطبيق إعدادات خاصة لمسار فرعي ما باستخدام ملف التهيئة الحالي باستخدام التأشيرة 
<صti0ة10c>‏ مع واصفة )هم مناسبة. 
في حال كان ملف التهيئة الحالي هو عاگمهء.عمذطعهص يمكننا تطبيق إعدادات خاصة بالمجلدات 


258 


Universal Knowledge Solutions s.a.1 


الافتراضية أو التطبيقات. اما في ملفات عاگرهء.طءس العادية فيمكنك ضبط الإعدادات لملف معين › 
مجلد » مجلد افتراضي أو تطبيق. 
مثال : 


<configuration> 


<location path="EnglishPages"> 
<system.web> 
<globalization 
requestEncoding="1iso-8859-1" 
responseEncoding="iso-8859-1" 
/< 
</system.web> 
</location> 


<location path="EnglishPages/OneJapanesePage.aspx"> 
<system.web> 
<globalization 
requestEncoding="Shift-JIS" 
responseEncoding="Shift-JIS" 
/< 
</system.web> 
</location> 


</configuration> 


إقفال إعدادات التهيئة : 

بالإضافة إلى تحديد إعدادات خاصة بواسطة التأشيرة <١٥اةءه[>‏ يمكننا تحديد إعدادات أمان معينة 
بحيث لا يتم تغيير هذه إعدادات التهيئة المحددة في هذا الملف بواسطة إعدادات تهيئة من ملف آخر . 
لإقفال مجموعة إعدادات يمكننا استخدام الواصفة e‏ لن٣إ6‏ 0۷س ااه على مواقع محددة و تعيينها إلى 
.false‏ 


في المثال التالي يقوم نص التهيئة بإقفال إعدادات التمثيل لتطبيقين مختلفين. 


<configuration> 


<location path="app1" allowOverride="false"> 
<system.web> 
<identity impersonate="false" userName="app1" password="applpw" /> 
</system.web> 
</location> 


<location path="app2" allowOverride="false"> 
<system.web> 
<identity impersonate="false" userName="app2" password="app2pw" /> 
</system.web> 
</location> 
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عند محاولة تجاوز هذا الإعداد و تغبيره باستخدام ملف تهيئة مختلف من الشكل : 


سوف يعيد النظام رسالة خطأ. 


كما ذكرنا يتم بشكل تلقائي توريث جميع الإعدادات الخاصة بالتهيئة إلى المجلد الذي يوجد فيه و جميع 
المجلدات الفرعية ضمنه. 

يمكن تطبيق إعدادات خاصة لمسار فرعي ما باستخدام ملف التهيئة الحالي باستخدام التأشيرة 
<«صati0ع0ا>‏ مع واصفة طاهم مناسبة. 

في حال كان ملف التهيئة الحالي هو عاگص0تء.ع«طعهص يمكننا تطبيق إعدادات خاصة بالمجلدات 
الافتراضية أو التطبيقات. اما في ملفات عاگ«هء.ط٠س‏ العادية فيمكنك ضبط الإعدادات لملف معين › 
مجلد › مجلد افتراضي أو تطبيق. 

إقفال إعدادات التهيئة : 

بالإضافة إلى تحديد إعدادات خاصة بواسطة التأشيرة <« 10اةءه1> يمكننا تحديد إعدادات أمان معينة 
بحيث لا يتم تغيير هذه إعدادات التهيئة المحددة في هذا الملف بواسطة إعدادات تهيئة من ملف آخر . 
لإقفال مجموعة إعدادات يمكننا استخدام الواصفة علا٣]‏ م0س ااه على مواقع محددة و تعيينها إلى 


.false 
ASP.NET الأقسام القياسية في ملف التهيئة ئ‎ 


هناك مجموعة من معالجات الأقسام القياسية التي تستخدم لمعالجة إعدادات التهيئة ضمن ملفات 
we.con‏ . الجدول التالي يبين الأقسام القياسية و ووصف لكل منها. 


اس اق الوصف 
<httpModules>‏ هذا القسم مسؤول عن ضبط الإعدادات الخاصة بالوحدات النمطية لما 
ضمن التطبيق. حيث أن هذه الوحدات تشترك في عملية معالجة جميع 
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<httpHandlers> 


<sessionState> 
<globalization> 
<compilation> 
<trace> 


<processModel> 


<browserCaps> 


تسح 4p N8۲‏ للمطورين بالوصضول إلى إعدادات التهيثة من خسن التطبيق بالوضول مباشرة إلى 


الطلبات الموجهة إلى التطبيق. من الاستخدامات الشائعة نواحي الأمان و 
عمليات تسجيل الدخول. 

هذا القسم مسؤول عن المحددات الواردة إلى الصفوف IHttp Handler‏ . 
لا ترث المجلدات الفرعية هذه الإعددات » كما أن هذا القسم مسؤول أيضا 
عن تو جیه المحددات URL‏ القادمة إلى صفوف 
.THttpHandlerFactory‏ 

هذا القسم مسؤول عن إعدادات الوحدة النمطية الخاصة بحالة الجلسة 

هذا القسم مسؤول عن الإعدادات الخاصة بالعالمية و التخصيص المحلي. 
هذا القسم مسؤول عن إعدادات الترجمة المستخدمة في .۸5۴.N ٤٣‏ 

هذا القسم مسؤول عن إعدادات خدمة التتبع في ۸8۶۲.۸۴۲ 

هذا القسم مسؤول عن إعدادات نموذج الإجرائية ۸5۶.٤٣‏ في نظام 
مخدم وب 118 


هذا القسم مسؤول عن التحكم بإعدادات مكون قدرات المستعرض 


استرجاع معلومات التهيئة 


الإعداد أو باستخدام الوصلات البينية البرمجية التطبيقية (۸۴1) . 


المثال التالي يبين صفحة تقوم بالوصول إلى قسم التهيئة <م2٣۲ءعws‏ 00> باستخدام اlخاصة Browser‏ 
ص System. Web.Http Request‏ . 
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Boolean Frames = <%=Request.Browser.Frames.ToString(%><br> 

Boolean JavaApplets = <%=Request.Browser.JavaApplets.ToString(%><br> 
Boolean JavaScript = <%=Request.Browser.JavaScript.ToString(%><br> 
Int32 MajorVersion = <%=Request.Browser.MajorVersion.ToString(%><br> 
Double MinorVersion = <%=Request.Browser.MinorVersion.ToString(%><br> 
String Platform = <%=Request.Browser.Platform%><br> 

Boolean Tables = <%=Request.Browser. Tables. ToString(%><br> 

String Type = <%=Request.Browser.Type%><br> 

Boolean VBScript = <%=Request. Browser. V BScript.ToString(%><br> 
String Version = <%=Request.Browser. Version %><br> 

Boolean Win1l6 = <%=Request.Browser. Win16.ToString(%><br> 

Boolean Win32 = <%=Request.Browser. Win32.ToString(%><Dbr> 


</body> 
</html> 


بار إن كاب الرصرن مد رة ولج المظرر الرصرل إلى ااك اة انتا 
الصف ع1 System.ConfigurationSe tt1‏ و استعادة البيانات من أي قسم في التهيئة. 

يجب الملاحظة هنا أن الغرض الذي تتم إعادته باستخدام Configuration S e٤11‏ یعتمد على معالج 
القن المعين لهذا القن : 

المثال التالي يوضح كيفية الوصول إلى بيانات التهيئة للقسم <1g؟‏ 0)01 >cus†0‏ . 

يفترض مثالنا أن معالج القسم سوف يعيد غرض من النمط sعCustomConfigSe))11‏ مع الخاصة 
Enabled‏ 


Dim config As CustomConfigSettings = CType(ConfigurationSettings("customconfig"), 
CustomConfigSettings) 


If config.Enabled = True Then 
' Do something here. 
End If 


استخدام إعدادات التطبيق 


قد يكون أحد الاستخدامات الأكثر أهمية لملفات التهيئة هو حفظ الإعدادات المخصصة للتطبيقات»متل 
الإعدادات الخاصة بسلسلة المحارف الخاصة بتعريف المزود و معلومات الاتصال بقاعدة بيانات ما › 
مسارات الملفات ءمواقع ملفات ×M[‏ ...إلخ. 

تتضمن الأقسام المعرفة تلقائياً (المحددة ضمن الملف عاnfهoء.عمmachin)‏ القسم <ع«t)iمSمpمa>‏ الذي 
يمكن استخدامه لتخزين الإعدادات على شكل ثنائيات (اسم/قيمة) . 

يظهر المثال التالي القسم <ءع”1ا)ء5ممه> الذي يعرف اتصال بقاعدة البيانات لتطبيق. 
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<configuration> 
<appSettings> 
<add key="pubs" value="server=(local)\NetSDK;database=pubs; Trusted_Connection=yes" /> 
<add key="northwind" 
value="server=(local)\NetSDK;database=northwind; Trusted_Connection=yes" /> 
<l/appSettings> 
</configuration> 


و فيما بلي النص البرمجي للصفحة التي سنقوم بالاستفادة فيه من القيمة المحفوظة في ملف إعدادات التهيئة. 
Import Namespace="System.Data" %>‏ @%< 

<%@ Import Namespace="System.Data.SqlClient" %> 

<%@ Import Namespace="System.Configuration" %> 


<html> 
<script language="VB" runat="server"> 
Sub Page_Load(Src As Object, E As EventArgs) 
Dim dsn As String = ConfigurationSettings.AppSettings(''pubs'") 


Dim MyConnection As SqlConnection 
Dim MyCommand As SqlDataAdapter 


MyConnection = New SqlConnection(dsn) 
MyCommand = New Sql1DataAdapter("select * from Authors", MyConnection) 


Dim DS As New DataSet 
MyCommand.Fill(DS, "Authors") 


MyDataGrid.DataSource= New DataView(DS.Tables(0)) 
MyDataGrid.DataBind() 
End Sub 


</script> 
<body> 
<h3><font face="Verdana">Retrieving Configuration Data</font></h3> 


<ASP:DataGrid id="MyDataGrid" runat="server" 
BackColor="#ccccff" 
BorderColor="black" 
ShowFooter="false" 
CellPadding=3 
CellSpacing="0" 
Font-Name="Verdana" 
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كما نلاحظ في المثال تم الوصول إلى قيم إعدادات التهيئة باستخدام التعبير : 


الفصل الثامن عشر - الجزء الأول 


عنوان الموضوع: 

الخبء في ASP.NET‏ 

الكلمات المفتاحية: 

خبء » انتهاء > صلاحية » خبء الخرج » الخبء الجزئي › خبء البيانات 


ملأخص : 

يعد الخبء من الآليات الضرورية و المستعملة في الكثير من المجالات لرفع الأداء. استفادت ۸5۴.٤١‏ من هذه التقنية و 
قدمت مجموعة من الطرق لاستخدامها. 

سنحاول خلال هذه الجلسة التعرف على هذه الطرق و كيفية تطبيقها. 


أهداف تعليمية: 

يتعرف الطالب في هذا الفصل على: 
٠‏ مفهوم الخبء و طرقه؛ 

٠‏ خبء الخرج 

ه الخبء الجزئي 

٠‏ خبء البيانات 


المخطط: 
الخبء في ۸8P۲.N۴1۲‏ 
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مقدمة عن الخبء 


ق تقنيات الخبء بصورة واسعة في مجال الحوسبة لرفع الأداء» وذلك بالمحافظة على البيانات التي يتم 
الوصول إليها بشكل متكرر» أوالبيانات ذات الكلفة العالية ( التي تستهلك الكثير من الموارد للوصول إليها) 
ضمن الذاكرة. 

و إعادة ۶١11ايستخدم‏ الخبء في مجال تطبيقات الوب للحصول على الصفحات أو البيانات عبر طلبات 
استخدام هذه البيانات دون عناء إعادة إتشاءها أو الحصول عليها. 


ثلاث أنواع من الخبء» والتي يمكن استخدامها في تطبيقات الوب:۲٤۸8۴.Nتوفر‏ 


الخبء الجزئي : حيث يتم خبء جزء من الاستجابة التي يولدها طلب ما؛ 


خبء البيانات : حيث يتم خبء أغراض محددة برمجيا . 


يكون خبء الخرج مفيداً في الحالات التي يمكن في خبء كامل الصفحة. فعلى المواقع التي يكون عليها تردد 
الطلب عالي» تكون عملية خبء صفحة و لو لدقيقة سبباً في تحسين كبير في الأداء. حيث يمكن تخديم الكثير 
من الطلبات لهذه الصفحة مباشرة دون تتفيذ النص الذي أنشأها . 


في بعض الأحيان لايكون خبء كامل الصفحة عمليا- بسبب حاجة الصفحة مثلا للتخصيص بترويسة خاصة 
بكل طلب. في هذه الحالة يكون من المجدي التعرف في الصفحة على الأغراض أو البيانات التي تحتاج كلفة 
(معالجة) عالية لإنشائها والصالحة ليتم خبئها. عندها يمكننا إنشاؤها و خبئها لمدة محددة من الزمن. كما يمكن 
أن تستخدم طريقة الخبئ الجزئي لخبئ مقاطع من خرج الصفحة. 


زمن الخبء: 

تة تمن الخ ناآ ل وات بات اا :. 

يمكن أن يتم تحديث البيانات بفواصل زمنية منتظمة أو بتحديد صلاحية البيانات بوقت محدد. 

في هذه الحالة يتم إعطاء العناصر سند انتهاء صلاحية يحدد إزالة العنصر من الخبء في حال انتهاء 
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الخبء. و في حال عدم توفرها يتم إعادة إنشائها حسب الحاجة. 


الملحقات ُن نوع ماف أو مفتاح خبءِ بذ ك ا المطور من إنشاء عناصر peaxASP.NET‏ الخبء في 
خبءِ تعتمد على ملف خارجي أو على عنصر خبء آخر حيث تستخدم هذه التقنية لإنهاء صلاحية عنصر 


خبء خرج الصفحة 


يعد خبء الخرج أحد التقنيات الفعالة في زيادة الانتاجية للعملية طلب/استجابة بإجراء خبء للمحتوى الذي 
يتم توليده من الصفحات الديناميكية. 


يكون خيار خبء الخرج مُفعل تلقائياً في 1٤p.Nء۸‏ و لكن عملياً لن يتم خبء أي استجابة لأي طلب ما 
لم اتخاذ إجراء واضح لجعل الاستجابة قابلة للخبء. 


لجعل استجابة ما قابلة للخبء لا بد من امتلاكها لسند صلاحية و انتهاء إضافة إلى قدرتها إلى على 
الوضزل لے لكب 


نکن ا ت ا اا کی رن : 
OutPut Cache API] €‏ (طریقة منخفضة المستوی) 
€ الموجه 21٣ا 0ut۴u‏ @ .(طريقة عالية المستوى) 


قول ت الخرج يتم إنشاء قيد خبء خر ج لدى أول طلب بالطريقة 6٤1‏ للصفحة. 
بعد هذا يتم تخديم جميع الطلبات (بالطريقة 6٤1‏ أو 1842]) التالية على هذه الصفحة من خبء الخرج 


يتبع خبء الخرج كما ذكرنا سندات الانتهاء و الصالحية الخاصة بالصفحة . فإذا كان صفحة ما في خبء 


الخرج و تم تحديد سند الانتهاء ب 60 دقيقة من بداية الخبء» سيتم إزالة الصفحة بعد انقضاء 60 دقيقة من 
خبءِ الخرج. 
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في حال تم استقبال طلب آخر بعد هذا التوقيت سيتم إعادة تنفيذ النص البرمجي على الصفحة و يمكن عندها 
خبء الصفحة من جديد. يطلق على هذا النمط من انتهاء الصلاحية اسم انتهاء الصلاحية المطلق . 


حيث يظهر الزمن عطءة ٣ں‏ ۲۴ا0 @يوضح المثال التالي طريقة بسيطة لخبء الخرج باستخدام الموجه 
الذي تم توليد الاستجابة فيه. 
لتعيين مدة الخبء ل 60 ثانية إضافة إلى تحديد قيمة الواصفة عطء u) ۴0)٣2‏ @ نلاحظ استخدامنا للموجه 


بمعنى أن الصفحة لن تختلف بحسب الطريقة المستخدمة سواء کان “٥٣”‏ إلى lالقيnة VaryByParam‏ 
GET ڪyİ POST.‏ 


<%@ OutputCache Duration="60" VaryByParam="none" %> 


<html> 
<script language="VB" runat="server"> 


Sub Page_Load(Src As Object, E As EventArgs) 
TimeMsg.Text = DateTime.Now.ToString("G") 


End Sub 
</script> 


<body> 
<h3><font face="Verdana">Using the Output Cache</font></h3> 


<p>x<i>Last generated on:</1> <asp:label id=" TimeMsg" runat="server"/> 


</body> 


</html> 


خبء الخرج 


أما بالنسبة للتطبيقات التي تريد سيطرة أكبر على تروسيات 1١۲۴‏ المتعلقة بالخبء فعليها استخدام الآلية 
التي يز ودا لص System. Web.HttpCache Policy‏ . 


Response.Cache.SetExpires(DateTime.Now.AddSeconds(60)) 
Response.Cache.SetCacheability(HttpCacheability.Public) 


لجعل السند المستخدم من النوع المنزلق تجري إعادة تأهيل زمن الانتهاء في كل مرة يتم فيها طلب الصفحة 
و ذلك باستخدام الخاصة Sliding Expirati0¬‏ 
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Response.Cache.SetSlidingExpiration(True) 


غك اكام س الاتتهاء المترلق يى الطات المرجة إلى التخد الصدر ذا باعادة استبابة 
يفيد الانتهاء المنزلق في الحالات التي يوجد فيها خبء يلبي حاجة الزبون» فإذا لم تنتهي صلاحية 
المحتويات يمكن الاستغناء عن طلبها من المخدم المصدر. 


كذلك تحافظ ۸8۴.٤1‏ على الطرق القديمة التي كانت مستخدمة في ۸5۴ وهي: 


Response.CacheControl = "Public" 
Response.Expires = 60 


مثال : 
في المثال التالي نلاحظ استخدام عنصر التحكم عكص ع11۳ لإظهار الزمن الحالي . 
سيظهر هذا النص البرمجي نفس القيمة لعنصر التحكم هذا فيما إذا كانت الصفحة ماتزال ضمن الخبء لأنه 
لن يتم إعادة تنفيذ الصفحة مرة أخرى. 


<%@ OutputCache Duration="60" VaryByParam="state" %> 
<%@ Import Namespace="System.Data" %> 
<%@ Import Namespace="System.Data.SqlClient" %> 


<html> 
<script language=" VB" runat="server"> 


Sub Page_Load(Src As Object, E As EventArgs) 
Dim MyConnection As SqlConnection 
Dim MyCommand As Sq1DataAdapter 
Dim ds As DataSet 
Dim queryState As String 
Dim selectCmd As String 


queryState = Request.QueryString( state") 
If queryState = Nothing 
selectCmd = "select * from Authors" 
Else 
selectCmd = "select * from Authors where state = 
End If 


N mi 


+ queryState + 


MyConnection = New 
SqlConnection(""server=(local)\NetSDK;database=pubs; Trusted_Connection=yes") 
MyCommand = New Sq1DataAdapter(selectCmd, MyConnection) 
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ds = New DataSet) 
MyCommand.Fill(ds, "Authors") 


MyDataGrid.DataSource=new DataView(ds.Tables(0)) 
MyDataGrid.DataBind() 


' capture the time of the current request 

' subsequent requests while we're still cached 

' will show the original time 

TimeMsg.Text = Date Time.Now.ToString("G") 
End Sub 


</script> 


<body> 
<h3><font face="Verdana">Using the Output Cache</font></h3> 


<b>Authors by State:</b> 


<table cellspacing="0" cellpadding="3" rules="all" style="background- 
color:#AAAADD;border-color:black;border-color:black;width:700px;border-collapse:collapse; "> 
<ir> 
<td><a href="outputcache3.aspx?state=CA">CA</a></td> 
<td><a href="outputcache3.aspx?state=IN">IN</a></td> 
<td><a href="outputcache3.aspx ?state=KS">KS</a></td> 
<td><a href="outputcache3.aspx?state=MD">MD</a></td> 
<td><a href="outputcache3.aspx?state=MI">MI</a></td> 
<td><a href="outputcache3.aspx?state=OR">OR</a></td> 
<td><a href="outputcache3.aspx ?state=TN">TN</a></td> 
<td><a href="outputcache3.aspx ?state=UT">UT</a></td> 
<ltır> 
</table> 


<p> 


<ASP:DataGrid 1d="MyDataGrid" runat="server" 
Width="700" 
BackColor="#ccccff" 
BorderColor="black" 
ShowFooter="false" 
CellPadding=3 
CellSpacing="0" 
Font-Name="Verdana" 
Font-Size="Spt" 
HeaderStyle-BackColor="#aaaadd" 
/< 


<p> 


<i>Last generated on:</i> <asp:label id=" TimeMsg" runat="server"/> 
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الخبء الجزئي 


بالإضافة إلى خبء الخرج لصفحة كاملة تقدم ۸5۴.٤٣‏ طريقة بسيطة لخبء خر ج أجزاء معينة من 
محتويات الصفحة . تسمى هذه العملية بالخبء الجزئي. 

تتم العملية بتحديد الأجزاء المراد خبئها بعنصر تحكم خاص بالمستخدم و تفعيل الخبء عليه باستخدام 
الموجه 18٥2٤1ما0u@‏ حيث يتم تحديد الزمن بالثواني لخبء هذه الأجزاء على المخدم . 


فعلى سبيل المثال يوعز التعبير التالي إلى 1٤N.مء4‏ بخبء الخرج لمدة 120 ثانية وبنسخ الخبء اعتمادا 
عذى SelectedID s Category1D çı‏ 


نقصد هنا بنسخ الخبء» إنشاء نسخة من الصفحة لكل قيمة ل 12رإهمعماهء أو d1DءtءمامS‏ لأن القيم 
في الخبء لن تكون صحيحة بالنسبة لجميع الطلبات. أي أن الخبء الذي يتم الوصول إليه في حالة 
المعملين التاليين مختلف: 


بالإضافة إلى دعم الموجه عاعa٣ out ۴u‏ للواصفة ۴2۲2۳ »۷ary8y‏ فإنه يدعم الواصفة 
VaryByControl‏ . 

يتم نسخ لخب« في VaryByControl]‏ افشلا على اختلاف عناصر التحكم ضمن عنصر التحكم الخاص 
بالمستخدم» في حين يتم نسخ الخبء في حالة ۲,8۴4۲4۳ه۷ اعتماداً على الثنائيات (اسم/قيمة) التي يتم 
إرسالھا باستخدام :Post yİ GET‏ 


ملاحظة: لا بد من استخدام الواصفة ۷2۲/8۷۲3۲۵۳ بصورة صريحة حتى في حال عدم الرغبة بتفعيل 


نسخ الخبء بناء على قيم المعاملات. 
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الخبء الجزئي 


ا ي غ ق E‏ 


يمكن توطين عناصر التحكم بصورة تكرارية ضمن الصفحة ( أي تعريف عنصر تحكم ضمن عنصر تحكم 


تقدم هذا الميزة نموذج مركب يمكن من خبء أجزاء مكونة من مجموعات خبء جزئية. 


يوضح المثال التالي كيف يتم خبء قسمين من قائمة باستخدام عناصر التحكم الخاصة بالمستخدم. 


<%@ Register TagPrefix=" Acme" TagName="Menu" Src="Menu.ascx" %> 


<html> 
<body> 
<table> 
<ir> 
<td> 
<Acme:Menu Category=" LeftMenu" runat=server/> 
</td> 
<td> 
<h1>Hi, the time is now: <%=Now%> </Ih1> 
</td> 
<td> 
<Acme:Menu Category="RightMenu" runat=server/> 
</td> 
<ir> 
</table> 
</body> 
</html> 


خبء البيانات 


٠ه‏ توفر ۸5S۲. N٤1‏ محرك خبء يمكن استخدامه ضمن الصفحات لحفظ واستعادة أغراض معينة عبر 
طلبات 1۲1° .H‏ 
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۵ يكون الخبء في 48۴.٤۲‏ خاص بكل تطبيق على حدة و يتم تخزينه في الذاكرة. 


٠‏ تكون مدة حياة ذاكرة الخبء متعلقة بمدة حياة التطبيق»ء فعند إعادة تشغيل التطبيق سيتم إعادة إنشاء 
ذاكرة الخبء من جديد. 


تقدم ۸5۴.٤1‏ واجهة برمجية بشكل فهرس بسيط يسمح للمستخدم بوضع الأغراض واستعادتها من 
الكباء: 


السيناريو الأبسط للقيام بهذه العملية هو التالي: 


و لاستعادة الغرض من الخبء يمكن بسهولة كتابة: 


أما بالنسبة للتطبيقات التي تتطلب وظائف أكثر تعقيداً فتوفر ۸8۴.٤1‏ مجموعة من الآليات مثل الكنس › 
الانتهاء و توابع الملفات و المفاتيح. 


خب ء البيانات 
مثال: 
يظهر المثال التالي الطريقة المبسطة لاستخدام الخبء حيث يقوم بتنفيذ استعلام على قاعدة البيانات و يقوم 
بخبء النتيجة » و التي يتم استخدامها خلال فترة حياة التطبيق. 


عند تشغيل هذا المثال سنلاحظ الرسالة في أسفل الصفحة. عند أول طلب للصفحة ستظهر أن النتيجة قد تم 
الاستحصال عليها من مخدم البيانات و بعدها سيتم إظهار رسالة تدل بأن المصدر هو معلومات الخبء 
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Sub Page_Load(Src As Object, E As EventArgs) 
Dim Source As DataView 


' try to retrieve item from cache 
'if it's not there, add it 


Source = Cache("MyDataSet") 
If Source Is Nothing 


Dim MyConnection As SqlConnection 
Dim MyCommand As SqlDataAdapter 


MyConnection = New 
SqlConnection("server=(local)\NetSDK;database=pubs; Trusted_Connection=yes") 
MyCommand = New SqlDataAdapter(""select * from Authors", MyConnection) 


Dim ds As New DataSet 
myCommand.Fill(ds, " Authors") 


Source = New DataView(ds.Tables("Authors")) 
Cache("MyDataSet") = Source 


CacheMsg. Text = "Dataset created explicitly" 
Else 

cacheMsg.Text = "Dataset retrieved from cache" 
End If 


MyDataGrid.DataSource=Source 
MyDataGrid.DataBind() 
End Sub 


</script> 
<body> 
<form method="GET" runat="server"> 
<h3><font face="Verdana">Caching Data</font></h3> 


<ASP:DataGrid id="MyDataGrid" runat="server" 
Width="700" 
BackColor="#ccccff" 
BorderColor="black" 
ShowFooter="false" 
CellPadding=3 
CellSpacing="0" 
Font-Name="Verdana" 
Font-Size="Spt" 
HeaderStyle-BackColor="#aaaad" /> 
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<p> 
<i><asp:label id="CacheMsg" runat="server"/></i> 
</form> 


</body> 
</html> 


مثال 2: 

في هذا المثال سيتم إظهار عنصر يعتمد على ملف ا١>.‏ 

الفكرة مشابهة للمثال السايق و لكن مضدر السعلومات هنا هى ملف X_‏ ء عند 'إصضنافة سجل جديد إلى 
الملف باستخدام النموذج ضمن الصفحة سيتم إعادة إنشاء العنصر في الخبء. 


<%@ Import Namespace="System.I]O" %> 
<%@ Import Namespace="System.Data" %> 


<html> 
<script language=" VB" runat="server"> 


Sub Page_Load(Src As Object, E As EventArgs) 
If Not IsPostBack 
LoadData() 
End If 
End Sub 


Sub NewAuthorBtn_Click(Src As Object, E As EventArgs) 

If Not Page.IsValid 

AuthorMsg.Text = "Some required fields are missing" 
Else 

Dim fs As FileStream 

Dim reader As StreamReader 

Dim ds As DataSet 

Dim newAuthor As DataRow 

Dim writer As TextWriter 


' open the file and read the current authors 

ds = New DataSet 

fs = New FileStream(Server.MapPath("authors.xm1"), FileMode.Open, File Access.Read, 
FileShare.ReadWrite) 

reader = New StreamReader(fs) 

ds.ReadXml(reader) 

fs.CloseO) 


' append a row 
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Try 
newAuthor = ds.Tables(0).NewRow(O 
newAuthor("au_id") = Authorld. Text 
newAuthor("au_Iname") = LastName. Text 
newAuthor("au_fname") = FirstName. Text 
newAuthor(' phone") = Phone. Text 
newAuthor("address") = Address. Text 
newAuthor('city") = City. Text 
newAuthor(""state") = AddressState. Text 
newAuthor("'zip") = PostalCode. Text 
newAuthor("contract") = Contract.Checked 
ds.Tables(0).Rows.Add(newAuthor) 

Catch Exc As Exception 
CacheMsg.Text = "Failed to create author with id = (" & Authorld.Text & ")<br>" & 

"Author already exists." 

Return 

End Try 


' rewrite the data file 

fs = New FileStream(Server.MapPath("authors.xm1"), FileMode.Create, 
FileAccess.ReadWrite, FileShare.ReadWrite) 

writer = New StreamWriter(fs) 

writer = TextWriter.Synchronized(writer) 

ds. WriteXml(writer) 

writer.Close() 


Cache.Remove("MyData") 
LoadData0) 
End If 
End Sub 


Sub RefreshBtn_Click(Src As Object, E As EventArgs) 
LoadData0) 
End Sub 


Sub LoadData 
Dim Source As DataView 


Source = Cache("MyData") 
If Source Is Nothing 
Dim ds As DataSet 
Dim fs As FileStream 
Dim reader As StreamReader 


' read the data from the XML source 

ds = New DataSet) 

fs = New FileStream(Server.MapPath("authors.xm1"), FileMode.Open,FileAccess.Read) 
reader = New StreamReader(fs) 

ds.ReadXml(reader) 

fs.Close) 
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Cache.Insert("MyData", Source, New CacheDependency(Server.MapPath("authors.xm1"))) 
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Source = New DataView(ds.Tables(0)) 


' cache it for future use 


' we created the data explicitly, so advertise that fact 
CacheMsg.Text = "Dataset created explicitly" 
Else 
CacheMsg. Text = "Dataset retrieved from cache" 
End If 


MyDataGrid.DataSource = Source 
MyDataGrid.DataBind() 
End Sub 


</script> 
<body> 
<form runat="server"> 
<h3><font face="Verdana">File Dependencies</font></h3> 


<ASP:DataGrid id="MyDataGrid" runat="server" 
Width="900" 
BackColor="#ccccff" 
BorderColor="black" 
ShowFooter="false" 
CellPadding=3 
CellSpacing="0" 
Font-Name="Verdana" 
Font-Size="Spt" 
HeaderStyle-BackColor="#aaaadd" 
/< 


<hr> 
<h3><font face="Verdana">Add New Author</font></h3> 


<asp:Label ID="AuthorMsg" Text="Fill in the required fields below to add a new author’ 
ForeColor="red" Font-Name="Verdana" Font-Size="10" runat=server /> 


<p> 


<table> 
<tr> 
<td>Author Id:</td> 
<td><ASP:TextBox id=Authorld Text="111-11-1111" runat=server/></td> 
<td><ASP:RequiredFieldV alidator ControlToValidate=" AuthorId" Display="Static" 
ErrorMessage="*" runat=server/></td> 
<ltı> 
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<tr> 
<td>Last Name:</td> 
<td><ASP:TextBox id=LastName Text=" Doe" runat=server/></td> 
<td><ASP:RequiredFieldV alidator ControlToValidate=" LastName" Display="Static" 
ErrorMessage="*" runat=server/></td> 
<ltı> 
<tr> 
<td>First Name:</td> 
<td><ASP:TextBox id=FirstName Text="John" runat=server/></td> 
<td><ASP:RequiredFieldV alidator ControlToValidate="FirstName" Display="Static" 
ErrorMessage="*" runat=server/></td> 
<tr> 
<İr> 
<td>Phone:</td> 
<td><ASP:TextBox id=Phone Text="555 555-5050" runat=server/></td> 
<td><ASP:RequiredFieldV alidator ControlToValidate="Phone" Display="Static" 
ErrorMessage="*" runat=server/></td> 
<tr> 
<tr> 
<td>Address:</td> 
<td><ASP:TextBox id=Address Text="One Microsoft Way" runat=server/></td> 
<td><ASP:RequiredFieldV alidator ControlToValidate=" Address" ErrorMessage="*" 
Display="Static" runat=server/></td> 
<tr> 
<tr> 
<td>City:</td> 
<td><ASP:TextBox 1d=City Text="Redmond" runat=server/></td> 
<td><ASP:RequiredFieldV alidator ControlToValidate="City" ErrorMessage="*" 
Display="Static" runat=server/></td> 
<ltı> 
<tr> 
<td>State:</td> 
<td><ASP:TextBox id=AddressState Text="WA" runat=server/></td> 
<td><ASP:RequiredFieldV alidator ControlToV alidate=" AddressState" ErrorMessage="*" 
Display="Static" runat=server/></td> 
<ltır> 
<İr> 
<td>Postal Code:</td> 
<td><ASP:TextBox id=PostalCode Text="98052" runat=server/></td> 
<td><ASP:RequiredFieldV alidator ControlToV alidate="Postal Code" ErrorMessage="*" 
Display="Static" runat=server/></td> 
<ltı> 
<tr> 
<td>Contract:</td> 
<td><ASP:CheckBox id=Contract Checked runat="server"/></td> 
<td></td> 
<tt> 
</table> 


<asp:button Text="Add New Author" OnClick="NewAuthorBtn_Click" runat=server/> 
<asp:button Text="Refresh List" OnClick="RefreshBtn_Click" runat=server/> 
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الجزء الثاني 


عنوان الموضوع: 
ورشة عمل 


الكلمات المفتاحية: 
فضاء العينة» حدث بسيط» حدث أكيد» حدث مستحيل» الأحداث المُستقلةء الاحتمال 


ملخض : 
الغرض من هذا الجزء من الجلسة استعراض حل بسيط متكامل لمتجر بقالة الكتروني» بالطبع سيتم التركيز 
على النواحي المتعلقة بكتابة النص البرمجي للتطبيق. 


أهداف تعليمية: 
يتعرف الطالب في هذا الفصل على: 
٠‏ كيفية دمج العناصر التعليمة التي تمت تغطيتها خلال الجلسات الماضية ضمن إطار عمل تطبيقي 


ورشة عمل 


يشل ها الجره من لجف ليق مكامل خرن لاء وة بي القتروهة مكل فة باتك 
VB.NE, ASP.NET‏ . 


تشمل المرحلة الأولى إنشاء الصفوف المناسبة للعمل على بيانات المتجر الالكتروني. سنقوم باستخدام 
۷B. NET‏ لإنشاء هذه الصفوف. 
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عار باقر شا ءات الما الطرهة 


Top of Form 

Imports System 

Imports System.Data 

Imports System.Data.SqlClient 
Imports System.Collections 


تم نعرف فضاء أسماء جديد ڊبlٺم OrderList «OrderlItem« InventoryDB فyèصزl janضتs Market‏ 


Namespace Market 
Public Class InventoryDB 
Public Function GetProducts(Byval categoryID as Integer) as DataTable 


Dim sqlConnectionl as SqlConnection 
sqlConnectionl = new 
SqlConnection("server=(local)\NetSDK;database=grocertogo; Trusted _Connection=yes") 


Dim sqlAdapter1 as SqlDataAdapter 
sqlAdapterl = new SqlDataAdapter("Select * from Products where categoryid=" & 
CStr(categoryID), SqlConnection1) 


Dim products As New Dataset 
sqlAdapter1.Fill(products, "products") 


Getproducts = products. Tables(0) 
End Function 


public Function GetProduct(productID As Integer) As DataRow 


Dim SqlConnectionl As SqlConnection 
SqlConnectionl = new 
SqlConnection("server=(local)\NetSDK;database=grocertogo; Trusted _Connection=yes") 


Dim SQLAdapterl As Sql1DataAdapter 
sqlAdapterl = new SqlDataAdapter("Select * from Products where productID=" & 
CStr(productID), sqlConnection1) 


Dim product As New DataSet 
sqlAdapter1.Fill(product, "product") 


GetProduct = product. Tables(0).Rows(0) 
End Function 


public Function GetProductCalories(productID As Integer) As DataTable 


Dim SqlConnectionl As SqlConnection 
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SqlConnectionl = New 
SqlConnection("server=(local)\NetSDK;database=grocertogo; Trusted _Connection=yes") 


Dim SQLAdapterl As Sq1DataAdapter 
sqlAdapterl = new Sql1DataAdapter("Select * from ProductDetails where productID=" & 
CStr(productID), sqlConnection1 ) 


Dim details As new DataSet 
sqlAdapter1.Fill(details, "details") 


GetProductCalories = details. Tables(0) 
End Function 
End Class 


public class OrderItem 


public m_ProductID As Integer 
public m_Quantity As Integer 
public m_Name As String 
public m_Price As Double 


public Sub New(ProductID As Integer, Name As String, Price As Double, Quantity As Integer) 
MyBase.New 
me.m_ProductID = ProductID 
me.m_Quantity = Quantity 
me.m_Name = Name 
me.m_ Price = Price 
End Sub 


public Readonly Property ProductID As Integer 
Get 
ProductID = m_ProductID 
End Get 
End Property 


public Property Quantity As Integer 
Get 
Quantity = m_Quantity 
End Get 


Set 
m_Quantity = Value 
End Set 
End Property 
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public Readonly Property Name As String 
Get 
Name = m_Name 
End Get 
End Property 


public Readonly Property Price As Double 
Get 
Price = m_Price 
End Get 
End Property 


public Readonly Property Total As Double 
Get 
Total = m_Quantity * m_Price 
End Get 
End Property 


End Class 


public class OrderList 


private m_Orders As Hashtable = new Hashtable 
private m_TaxRate As Double = 0.08 


public Readonly Property SubTotal As Double 
Get 


If (m_Orders.Count = 0) then 
SubTotal = 0.0 
End If 


Dim x as OrderlItem 

For Each x in m_Orders. Values 
SubTotal += x.Price * x.Quantity 

Next x 


End Get 
End Property 


public Property TaxRate As Double 
Get 
TaxRate = m_TaxRate 
End Get 


Set 
m_TaxRate = TaxRate 
End Set 
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End Property 


public Readonly Property Tax As Double 
Get 
Tax = SubTotal * m_TaxRate 
End Get 
End Property 


public Readonly Property Total As Double 
Get 
Total = SubTotal * (1 + m_TaxRate) 
End Get 
End Property 


public Readonly Property Values As ICollection 
Get 
Values = m_Orders. Values 
End Get 
End Property 


' This is the Default property 
public Default Readonly Property DefaultProp(name As String) As OrderItem 
Get 
DefaultProp = CType(m_Orders(name),OrderItem) 
End Get 
End Property 


public Sub Add(value As OrderlItem) 
If Microsoft. VisualBasic.IsNothing(m_Orders(value.Name)) Then 
m_Orders.Add(value.Name, value) 
Else 
Dim ol as OrderItem 
ol = Ctype(m_Orders(value.Name), OrderItem) 
o1.Quantity = o1.Quantity + 1 
End If 
End Sub 


public Sub ClearCart) 
m_Orders.Clear) 
End Sub 
End Class 


End Namespace 
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سنقوم في الملف ×عهءه.21طهاع باستخدام نص برمجي لإنشاء مثيل عن ئ۲11٥‏ ل0۲ ووضعه ضمن متحول 
جلسة ليتم استخدامه من قبل المستخدم في الجلسة كبطاقة شراء. 

<%@ Import Namespace="Market" %> 

<script language=" VB" runat=server> 


public Sub Session_Start() 


If Microsoft. VisualBasic.IsNothing(Session("ShoppingCart")) Then 
Session("ShoppingCart") = new Market.OrderList() 
End If 
End Sub 


</script> 


ثم سنبدأً بكتابة نص ×م5ه (النص يشكل ملف ×مءه وحيد و لكننا هنا نقوم بتفصيل كل جزء على حدة). 
Import Namespace="System.Data" %>‏ @%< 
Import Namespace="Market" %>‏ @%< 


<html> 
<head> 
<title>GrocerToGo</title> 
<link rel="stylesheet" href=" grocerstyle.css"> 


<style> 
div.details { background-color:ffffcc; padding-top:15; padding-bottom:20; } 
div.details table { width:375; } 
div.details table td { font-family: Verdana; font-size:Spt; } 

</style> 


<script language="VB" runat=server> 
public Sub Page_Load(sender As Object, e As EventArgs) 
if (Not IsPostBack) Then 
ProductListing.SelectedIndex = 0 
UpdateProducts() 
UpdateShoppingCart) 


End If 
End Sub 


نلاحظ في المقطع السابق أننا قمنا بكتابة النص البرمجي لتحميل الصفحة و تأكدنا في كل مرة من استخدام 
لطر UpdateShoppingCart sy UpdateProducts‏ للتأکد من تحديث قائمة المنتجات في الصفحة و 
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العناصر في سلة الشراء و المخزنة في غرض الجلسة. 


ثم سنقوم بكتابة النص البرمجي الخاص بالأحداث المرتبطة بالتفاعل مع واجهة التطبيق كاختيار عنصر من 
قائمة التصنيفات المتوفرة أو الضغط على زر الإضافة لعنصر إلى سلة الشراء..إلخ 
public Sub CategoryList_Select(sender As Object, e As EventArgs)‏ 
CurrentCategory.Text = CategoryList.Items(CategoryList.SelectedIndex). Text‏ 


UpdateProducts() 
End Sub 


public Sub ProductListing Select(sender As Object, e As EventArgs) 
UpdateProducts() 
End Sub 


public Sub AddBtn_Click(sender As Object, e As ImageClickEventArgs) 
Dim productID As Integer 
productID = Int32.Parse(ProductListing.DataKeys(ProductListing.SelectedIndex).ToString()) 


Dim market As InventoryDB 
market = new InventoryDB() 


Dim product As DataRow 
product = market.GetProduct(productID) 


Dim shoppingCart As Market.OrderList 
shoppingCart = Ctype(Session("ShoppingCart"), Market.OrderList) 


shoppingCart.Add(new Market.OrderItem(productID, CStr(product("ProductName")), 
Double.Parse(product("UnitPrice").ToString()), 1)) 


UpdateShoppingCartO 

End Sub 

public Sub Recalculate_Click(sender As Object, e As ImageClickEventArgs) 
' Obtain Shopping Cart From Session State 


Dim shoppingCart As Market.OrderList 
shoppingCart = Ctype(Session("ShoppingCart"), Market.OrderList) 


' Iterate over items in shopping cart (update cart with current row qty textbox value 


Dim i As Integer 
Dim qty As HtmlInput Text 


for i = 0 To ShoppingCartList.Items.Count - 1 
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qty = Ctype(ShoppingCartList.Items(i).FindControl("Qty"), HtmlInputText) 
Try 
shoppingCart(CStr(ShoppingCartList.DataKeys(1))).Quantity = CInt(qty. Value) 
Catch exc As Exception 
End Try 
Next i 


UpdateShoppingCartO 

End Sub 

public Sub ClearCart_Click(sender As Object, e As ImageClickEventArgs) 
' Obtain access to Shopping Cart From Session State 


Dim shoppingCart As Market.OrderList 
shoppingCart = Ctype(Session("ShoppingCart"), Market.OrderList) 


' Clear Items From Shopping Cart and then Update UI 
shoppingCart.ClearCartO) 


UpdateShoppingCartO 
End Sub 


فيما يلي النص البرمجي للتوابع المعرفة مسبقاً و الخاصة كما ذكرنا بتحديث قائمة المنتجات: 
Sub UpdateProducts()‏ 


Dim market As New InventoryDB 
' Update Product Listing at Bottom of Page 


Dim categoryID As Integer 

categoryID = Int32.Parse(CategoryList.Items(CategoryList.SelectedIndex). Value) 
ProductListing.DataSource = market.GetProducts(categoryID).Default View 
ProductListing.DataBind() 


' Update Product Information 


Dim productID As Integer 
productID = Int32.Parse(ProductListing.DataKeys(ProductListing.SelectedIndex).ToString()) 


Dim product As DataRow 
product = market.GetProduct(productID) 


Name. Text = product("ProductName").ToStringO) 
SelectedProdPicture.Src = product("ImagePath").ToString() 
ServingSize.Text = product("ServingSize").ToStringO) 
Servings. Text = product("Servings").ToString() 
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' Update Product Calory Information 


DetailsListing.DataSource = market.GetProductCalories(productID).Default View 
DetailsListing.DataBind() 
End Sub 


Sub UpdateShoppingCart() 
' Update Shopping Cart UI from Basket Stored in Session State 


Dim shoppingCart As Market.OrderList 
shoppingCart = Ctype(Session("ShoppingCart"), Market.OrderList) 


SubTotal.Text = System.String.Format("{0:C}", shoppingCart.SubTotal) 
Tax.Text = System.String.Format(" {0:C}", shoppingCart. Tax) 
Total. Text = System.String.Format(" {0:C}", shoppingCart. Total) 


ShoppingCartList.DataSource = shoppingCart. Values 
ShoppingCartList.DataBind() 
End Sub 


</script> 


يظهر في هذا الجزء تصميم الصفحة مع عناصر التحكم من جهة المخدم المستخدمة مثل قوائم الاختيار و 


الصور. 
</head>‏ 
<body topmargin="0" leftmargin="0" marginwidth="0" marginheight="0">‏ 


<form runat="server"> 


<table cellspacing=0 cellpadding=3 bgcolor="DC6035" border=0 width="100%"> 
<tr> 
<td align="left"><img src="images/logo.gif" ></td> 
<td align="right"> 
<a><img border=0 src="images/home.gif"></a> 
</td> 
<ltı> 
<İr> 
<td align="right" class="select" colspan="2"> 


<b>Select Category: &nbsp;</b> 


<select id="CategoryList" style="width:75" runat="server"> 
<option selected value="1">Milk</option> 
<option value="2">Cereal</option> 
<option value="3">Soda</option> 

</select> 
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<asp:button text="Select" OnClick="CategoryList_Select" runat=server/> 


</td> 
<tr> 
</table> 


<table border=0 width=100% cellspacing=0 cellpadding=15 bgcolor="ffffcc"> 
<İr> 


<td valign=top bgcolor=ffffcc> 
<p> 


<h3> 
<b>Product Category: <asp:label id="CurrentCategory" 
runat=server>Milk</asp:label><b> 
</h3> 


<table width="100%" cellpadding=0 cellspacing=0O > 
<tr style="padding-left:12" > 
<td align="center" style="border-style:inset;" bgcolor="EDBE7B" width=140> 
<img id="SelectedProdPicture" runat=server> 
</td> 
<td align="center" bgcolor="ffffcc" style="padding-right:0;"> 


<div class="details'"> 


<table cellpadding=1 > 
<ir> 
<td colspan=3> 
<b><font face="Verdana" size=3><asp:label id="Name" runat=server> 
<l/asp:label></font></b> 
</td> 
<td align=right> 
<asp:imagebutton ImageUrl="images/addcart. gif" 
OnClick="AddBtn_Click" runat=server/> 
</td> 
<tr> 
<tr> 
<td colspan=4 > 
Serving Size <asp:label id="ServingSize" runat=server> </asp:label> 
<ltd> 
<tr> 
<tr> 
<td colspan=4> 
Servings Per Container <asp:label id="Servings" runat=server> 
</asp:label> 
<ltd> 
<tr> 
<ir> 
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<td height=5 colspan=4 bgcolor="000000"'></td> 
<tr> 
</table> 


<asp:repeater id="DetailsListing" runat="server"> 


<ItemTemplate> 
<table cellpadding=0> 
<tr> 
<td colspan=3> 
<b><%# DataBinder.Eval(Container.Dataltem, "Name") %></b> 
<%# DataBinder.Eval(Container.Dataltem, "Grams") %> 
</td> 
<td align=right> 
<b><%# DataBinder.Eval(Container.Dataltem, "Percent") %>%</b> 
</td> 
<ltr> 
</table> 
</ItemTemplate> 


<SeparatorTemplate> 
<table cellpadding=0 > 
<ir> 
<td colspan=4 height=1 bgcolor="000000"></td> 
<tr> 
</table> 
</SeparatorTemplate> 


<FooterTemplate> 
<table cellpadding=0 > 
<ir> 
<td colspan=4 height=5 bgcolor="000000"></td> 
<tr> 
</table> 
</FooterTemplate> 


</asp:repeater> 


</div> 
</td> 
<ltr> 
</table> 


<p> 
<table> 
<tr> 


<td class="products"> 


<asp:datalist id="ProductListing" DataKeyField="ProductID" showheader=false 
showfooter=false OnSelectedIndexChanged="ProductListing Select" repeatdirection="horizontal" 
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borderwidth=0 runat="server"> 


<ItemTemplate> 
<table> 
<İr> 
<td width="150"> 


<asp:imagebutton borderwidth=6 bordercolor="#ffffcc" 
commandname="Select" ImageUrl='<%# DataBinder.Eval(Container.Dataltem, "ImagePath") %>' 
runat=server/> 


<p> 


<%# DataBinder.Eval(Container.Dataltem, "ProductName") %> 


<br> 
<%# DataBinder.Eval(Container.Dataltem, "UnitPrice", "{0:C}") 
%><br> 
</td> 
<ltr> 
</table> 
</ItemTemplate> 


<SelectedItemTemplate> 
<table> 
<tr> 
<td width="150"> 


<asp:imagebutton borderwidth=6 bordercolor="red" 
commandname="select" ImageUrl='<%# DataBinder.Eval(Container.Dataltem, "ImagePath") %>' 
runat=server/> 


<p> 


<%# DataBinder.Eval(Container.Dataltem, "ProductName") 


Yo><br> 
<%# DataBinder.Eval(Container.Dataltem, "UnitPrice", "{0:C}") 
o><br> 
</td> 
<ltr> 
</table> 


</SelectedItemTemplate> 
</asp:datalist> 
</td> 
<ltr> 


</table> 


</td> 


<td width="315" valign=top class="cart" bgcolor="#EDBE7B'"> 
Universal Knowledge Solutions s.a.1 289 


290 


<h3>Your Shopping Cart</h3> 


<asp:datalist id="ShoppingCartList" DataKeyField="Name" borderwidth=0 
runat="server"> 


<HeaderTemplate> 


<table width="100%"> 
<i> 
<td width=35> 
<b>Qty</b> 
</td> 
<td width=175> 
<b>Product</b> 
</td> 
<td width=50> 
<b>Price</b> 
</td> 
<td align="right" style="padding-right:10"> 
<b>Total</b> 
</td> 
<ltr> 


</HeaderTemplate> 
<ItemTemplate> 


<tr> 
<td width=35> 
<input type=text size=1 1d="Qty" runat=server value='<%# 
DataBinder.Eval(Container.Dataltem, "Quantity") %>'> 
</td> 
<td width=175> 
<%# DataBinder.Eval(Container.Dataltem, "Name") %> 
</td> 
<td width=50> 
<%# DataBinder.Eval(Container.Dataltem, "Price", "{0:C}") %> 
</td> 
<td align=right style="padding-right:10"> 
<%# DataBinder.Eval(Container.Dataltem, "Total", "{0:C}") %> 
</td> 
<ltr> 


</ItemTemplate> 
<FooterTemplate> 


</table> 


</FooterTemplate> 
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<l/asp:datalist> 


<table border=0 width="100%'"> 
<I> 
<td colspan=4><hr></td> 
<tr> 
<I> 
<td width=52></td> 
<td width=225 colspan="2" align="left"> 
<b>Subtotal</b> 
</td> 
<td align="right" style="padding-right:10"> 
<asp:label id="Sub Total" runat=server/> 
</td> 
<tr> 
<tr> 
<td width=52></td> 
<td width=225 colspan="2" align="left"> 
<b>Tax</b> 
<ltd> 
<td align="right" style="padding-right:10"> 
<asp:label id=" Tax" runat=server/> 
<ltd> 
<tr> 
<tr> 
<td width=52></td> 
<td width=225 colspan="2" align="left"> 
<b>Grand Total</b> 
</td> 
<td align="right" style="padding-right:10"> 
<b><asp:label id="Total" runat=server/></b> 
<ltd> 
<ltı> 
</table> 


<p> 


<div id="CheckoutPanel" runat="server"> 
<center> 
<asp:imagebutton borderwidth=0O OnClick="Recalculate_Click" 
ImageUrl='images\recalculate.gif' runat=server/> 
<asp:imagebutton borderwidth=0 ImageUrl='images\checkout. gif’ 
runat=server/> 
<asp:imagebutton borderwidth=0Û0 OnClick="ClearCart_Click" 
ImageUrl='images\clear_cart.gif' runat=server/> 
</center> 
</div> 


</td> 
<ltr> 
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